# Zapier

Zap, care ia data, ora, zona și coordonatele de naștere din trigger, solicită API-ul hărții și transformă Ascendentul în numele semnului. Cererea de mai jos a fost trimisă la producție exact în forma în care o creează pasul; pașii în Zapier sunt scrise conform documentației Zapier din 2026-09-17.

<Aside type="caution" title="Потрібен платний тариф Zapier">
API by Zapier, Webhooks by Zapier și Formatter sunt aplicații premium. Documentația Zapier marchează toate trei ca nefiind disponibile pe planul Free, iar pasul Lookup Table necesită planul Professional sau superior. Pe planul Free folosește [Make](/integrations/make/) sau [n8n](/integrations/n8n/).
</Aside>

Începe prin a crea cheia, așa cum este descris în secțiunea [Cheie pentru automatizare](/integrations/#ключ-для-автоматизації), cu domeniul `chart`.

## 1. Pune cheia în legătură
Antetele introduse în pasul Webhooks by Zapier sunt stocate în propriul pas și sunt vizibile pentru oricine are acces la Zap. API by Zapier le păstrează în legătură.

1. Pe pagina **Apps** apasă **+ Add connection** și selectează **API by Zapier**.
2. **Tipul de autentificare**: Static Headers (cheie API).
3. **Antete**: `X-Api-Key: ` și apoi cheia ta, pe un singur rand.
4. **Filtrare domeniu**: `api.astroway.info`, pentru ca legătura să nu poată fi redirecționată altundeva.

## 2. Apelează harta
Adaugă o acțiune, selectează **API by Zapier**, evenimentul **API Request** și legătura.

- **Metoda**: `POST`.
- **URL**:

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

- **Corpul**: JSON-ul de mai jos cu câmpurile triggerului în loc de valori.
```json
{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": "50.45",
  "longitude": "30.52"
}
```

Înlocuiește fiecare valoare cu câmpul triggerului corespunzător și lasă ghilimelele în jurul fiecăruia, chiar și pentru numere. Zapier inserează câmpul potrivit ca text simplu și nu adaugă ghilimele, iar API primește `"50.45"` ca un număr. Cheia din antetele pasului nu trebuie adăugată: ea este furnizată de legătură.

Testează pasul. Răspunsul corect începe cu `"ok": true`, iar `data.input.timezoneOffset` pentru exemplu are valoarea `4`: deplasamentul pe care îl avea Ziua aceea.

## 3. Transformă Ascendentul în semn
Două pași Formatter.
**Formatter, acțiunea Numbers, transformare tipo foaie de calcul.** Formula:
```
FLOOR(ASCENDANT / 30)
```
în loc de `ASCENDANT` a fost pus `data.houses.ascendant` din pasul 2. Pentru exemplu rezultatul este `5`.
**Formatter, acțiunea Utilities, transformare Lookup Table.** Cheia de căutare este rezultatul formulei. Tabelul:
| Cheie | Valoare |
|---|---|
| 0 | Aries |
| 1 | Taurus |
| 2 | Gemini |
| 3 | Cancer |
| 4 | Leo |
| 5 | Virgo |
| 6 | Libra |
| 7 | Scorpio |
| 8 | Sagittarius |
| 9 | Capricorn |
| 10 | Aquarius |
| 11 | Pisces |
Pentru exemplu rezultatul este `Virgo`. Pentru a obține numele în română, scrie-le în coloana Valoare.
Soarele și Luna se calculează la fel. Sunt primul și al doilea înregistrare din `data.planets`, fiecare având propria `longitude`: de exemplu 54.34 (Bivol) și 296.39 (Capricorn).

## Dacă folosești Webhooks by Zapier
Funcționează, dar cheia rămâne în pas, nu în legătură. Pentru hartă, selectează evenimentul **Custom Request**: trimite câmpul Data exact așa cum l-ai introdus, deci JSON-ul de mai jos va rămâne neschimbat. Setează **Method** `POST`, iar în **Headers** adaugă și `X-Api-Key` cu cheia ta, și `Content-Type` cu valoarea `application/json`.

## Când pasul eșuează
- **`400 INVALID_FIELD` cu `timezone` în `details`**: zonă potrivită este goală, este o abreviație de genul `EST` sau nu este un nume de zonă.
- **`400` cu `date` sau `time` în `details`**: formatul triggerului nu este `YYYY-MM-DD` / `HH:MM:SS`; adaugă înainte de apel un pas Formatter pentru dată.
- **`403 ENDPOINT_NOT_IN_SCOPE`**: în domeniul cheii nu există `chart`.
- **`429 KEY_BUDGET_EXHAUSTED`**: cheia a epuizat propriul buget; crește-l în dashboard.

API nu face geocodare. Dacă triggerul are doar numele unui loc, coordonatele trebuie să vină de la triggerul însuși sau de la un serviciu de geocodare la care ai cheie.
