# Zapier

Zap, který bere datum, čas, zónu a souřadnice narození z triggeru, požaduje v API mapu a převádí Ascendent na název znamení. Požadavek níže byl odeslán do produkce právě v tom tvaru, v jakém jej sestavuje krok; kroky v Zapier jsou napsány podle dokumentace Zapier k 2026-09-17.

<Aside type="caution" title="Potřebný placený tarif Zapier">
API by Zapier, Webhooks by Zapier a Formatter jsou prémiové aplikace. Dokumentace Zapier označuje všechny tři jako nedostupné v tarifu Free, a krok Lookup Table vyžaduje tarif Professional nebo vyšší. Ve Free použij [Make](/integrations/make/) nebo [n8n](/integrations/n8n/).
</Aside>

Nejprve vytvoř klíč, jak je popsáno v sekci [Klíč pro automatizaci](/integrations/#ключ-для-автоматизації), s oblastí `chart`.

## 1. Umísti klíč do spojení

Hlavičky zadané v kroku Webhooks by Zapier jsou uloženy přímo v kroku a vidí je každý, kdo má přístup k Zap. API by Zapier je drží ve spojení.

1. Na stránce **Apps** klikni na **+ Add connection** a vyber **API by Zapier**.
2. **Authentication type**: Static Headers (API key).
3. **Headers**: `X-Api-Key: ` a poté tvůj klíč, v jednom řádku.
4. **Domain filter**: `api.astroway.info`, aby spojení nemohlo být nasměrováno někam jinam.

## 2. Vyvolej mapu

Přidej akci, vyber **API by Zapier**, událost **API Request** a spojení.

- **Method**: `POST`.
- **URL**:

  ```
  https://api.astroway.info/v1/chart
  ```

- **Body**: JSON níže s poli triggeru místo hodnot.

```json
{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": "50.45",
  "longitude": "30.52"
}
```

Nahraď každou hodnotu odpovídajícím polem triggeru a ponech uvozovky kolem každé, i čísla. Zapier vloží přiřazené pole jako prostý text a uvozovky nepřidá, ale API přijímá `"50.45"` jako číslo. Klíč v Headers kroku nepřidávej: vloží ho spojení.

Otestuj krok. Správná odpověď začíná `"ok": true`, a `data.input.timezoneOffset` pro příklad je `4`: posun, který Kyjev měl toho dne.

## 3. Převod Ascendentu na znamení

Dva kroky Formatter.

**Formatter, událost Numbers, převod Spreadsheet-Style Formula.** Formula:

```
FLOOR(ASCENDANT / 30)
```

kde místo `ASCENDANT` je vloženo `data.houses.ascendant` z kroku 2. Pro příklad výsledek je `5`.

**Formatter, událost Utilities, převod Lookup Table.** Lookup Key je výsledek formule. Tabulka:

| Key | Value |
|---|---|
| 0 | Aries |
| 1 | Taurus |
| 2 | Gemini |
| 3 | Cancer |
| 4 | Leo |
| 5 | Virgo |
| 6 | Libra |
| 7 | Scorpio |
| 8 | Sagittarius |
| 9 | Capricorn |
| 10 | Aquarius |
| 11 | Pisces |

Pro příklad výsledek `Virgo`. Pro získání českých názvů je vlož do sloupce Value.

Slunce a Měsíc se počítají stejně. To je první a druhý záznam v `data.planets`, každý s vlastní `longitude`: pro příklad 54.34 (Býk) a 296.39 (Kozoroh).

## Pokud používáš Webhooks by Zapier

Funguje, ale klíč je v kroku, ne ve spojení. Pro mapu vyber událost **Custom Request**: odešle pole Data přesně tak, jak je zadáno, takže JSON výše půjde beze změny. Nastav **Method** `POST` a v **Headers** přidej jak `X-Api-Key` s tvým klíčem, tak `Content-Type` s hodnotou `application/json`.

## Když krok selže

- **`400 INVALID_FIELD` s `timezone` v `details`**: přiřazená zóna je prázdná, je to zkratka jako `EST` nebo ne název zóny.
- **`400` s `date` nebo `time` v `details`**: formát triggeru není `YYYY-MM-DD` / `HH:MM:SS`; přidej před voláním krok Formatter pro datum.
- **`403 ENDPOINT_NOT_IN_SCOPE`**: v oblasti klíče není `chart`.
- **`429 KEY_BUDGET_EXHAUSTED`**: klíč vyčerpal svůj rozpočet; zvedni ho v dashboardu.

API negeokóduje. Pokud trigger má jen název místa, souřadnice musí přijít přímo z triggeru nebo ze služby geokódování, ke které máš klíč.