# Zapier A Zap, amely a dátumot, időt, zónát és a születési koordinátákat veszi a triggerből, lekérdezi az API-tól a kart és az Aszcendenst a jel nevére alakítja. Az alábbi kérés a production környezetbe pontosan úgy lett elküldve, ahogy a lépés összeállítja; a Zapier lépések a Zapier dokumentációja szerint 2026-09-17 állapotban. Először hozd létre a kulcsot, ahogy a [Kulcs az automatizáláshoz](/integrations/#ключ-для-автоматизації) szakaszban le van írva, a `chart` területtel. ## 1. Helyezd el a kulcsot a kapcsolatba A Webhooks by Zapier lépésben megadott fejlécek a lépésben tárolódnak, és mindenki látja, aki hozzáfér a Zap-hez. Az API by Zapier a kapcsolatban tárolja őket. 1. Az **Apps** oldalon kattints a **+ Add connection** gombra, majd válaszd az **API by Zapier**-t. 2. **Authentication type**: Static Headers (API key). 3. **Headers**: `X-Api-Key: ` majd a kulcsod, egy sorban. 4. **Domain filter**: `api.astroway.info`, hogy a kapcsolatot ne lehessen máshová irányítani. ## 2. Hívj meg egy chart-ot Adj hozzá egy műveletet, válaszd az **API by Zapier**-t, az **API Request** eseményt és a kapcsolatot. - **Method**: `POST`. - **URL**: ``` https://api.astroway.info/v1/chart ``` - **Body**: A JSON alább a trigger mezőkkel az értékek helyett. ```json { "date": "1990-05-15", "time": "14:30:00", "timezone": "Europe/Kyiv", "latitude": "50.45", "longitude": "30.52" } ``` Cseréld le minden értéket a megfelelő trigger mezőre, és tartsd meg az idézőjeleket minden körül, a számoknál is. A Zapier a hozzárendelt mezőt egyszerű szövegként illeszti be, és nem ad hozzá idézőjeleket, míg az API a `"50.45"`-t számként fogadja. A kulcsot a Headers lépésben ne add meg: a kapcsolat helyettesíti. Teszteld a lépést. A helyes válasz `"ok": true`-vel kezdődik, és a `data.input.timezoneOffset` például `4`-nek felel meg: a Kyiv által abban a napban használt eltolás. ## 3. Alakítsd át az Aszcendenst jelre Két Formatter lépés. **Formatter, Numbers esemény, Spreadsheet-Style Formula átalakítás.** Képlet: ``` FLOOR(ASCENDANT / 30) ``` ahol az `ASCENDANT` helyett a 2. lépésből származó `data.houses.ascendant` van beillesztve. Például ez `5`-öt ad. **Formatter, Utilities esemény, Lookup Table átalakítás.** A Lookup Key a képlet eredménye. Táblázat: | 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 | Például az eredmény `Virgo`. Ha magyar neveket szeretnél, írd be őket a Value oszlopba. A Nap és a Hold is ugyanígy számolható. Ezek az első és második bejegyzés a `data.planets`-ben, mindegyik saját `longitude`-val: például 54.34 (Bika) és 296.39 (Bak). ## Ha a Webhooks by Zapier-t használod Működik, de a kulcs a lépésben van, nem a kapcsolatban. A chart-hoz válaszd a **Custom Request** eseményt: ez pontosan úgy küldi el a Data mezőt, ahogy be van adva, így a fenti JSON változtatás nélkül megy. Állítsd be a **Method** `POST`-ra, és a **Headers**-hez add hozzá az `X-Api-Key`-t a saját kulcsoddal, valamint a `Content-Type`-t `application/json` értékkel. ## Amikor a lépés hibát dob - **`400 INVALID_FIELD` a `timezone`-nél a `details`-ben**: a hozzárendelt zóna üres, ez egy rövidítés, például `EST`, vagy nem egy zóna neve. - **`400` a `date` vagy `time`-nél a `details`-ben**: a trigger formátuma nem `YYYY-MM-DD` / `HH:MM:SS`; adj hozzá egy Formatter lépést a dátumhoz a hívás előtt. - **`403 ENDPOINT_NOT_IN_SCOPE`**: a kulcs területén nincs `chart`. - **`429 KEY_BUDGET_EXHAUSTED`**: a kulcs kimerítette a saját költségkeretét; emeld fel a dashboardon. Az API nem geokódol. Ha a trigger csak a hely nevét tartalmazza, a koordinátáknak a triggerből vagy egy olyan geokódoló szolgáltatásból kell érkezniük, amelyhez van kulcsod.