# Kód nélküli integrációk

Minden ezen az oldalon a production ellen 2026-09-17-ig készült. A n8n workflow importálva és elindítva a valódi n8n-ben; a Zapier és a Make lépései a saját dokumentációjuk alapján íródtak, és a kérések, amelyeket összeállítanak, pontosan ebben a formában kerülnek elküldésre.

## Honnan jön a kérés

Ez határozza meg, hogy melyik kulcs szükséges.

- **Zapier, Make és n8n** elküldik azt a saját szervereikről. „Csak szerver” kulcsra van szükség a végpontok területével és költségkerettel, ahogy alább le van írva. Útmutatók: [Zapier](/integrations/zapier/), [Make](/integrations/make/), [n8n](/integrations/n8n/).
- **Bubble** is szintén a saját szervereiről küld kéréseket, és a kulcs a fejlécben marad: [Bubble](/integrations/bubble/).
- **FlutterFlow** egy alkalmazásba fordul, amelyet a felhasználó tart, ezért a hívást privátnak kell lennie: [FlutterFlow](/integrations/flutterflow/).
- **Wix, Squarespace, Shopify, Webflow és Tilda** a látogató böngészőjében jelenítik meg az oldalt. Helyezd be a widgetet, ne a kulcsot: [weboldalkészítők](/integrations/site-builders/).
- **WordPress** a saját szerveredről hívja meg. A kulcsot a [AstroWay bővítmény](https://wordpress.org/plugins/astroway/) kezeli.

<Aside type="caution">
A nyilvános `pk_` kulcs nem működik Zapierrel, Make‑vel vagy n8n‑nel. Elutasítja a kérést origin nélkül a saját listájából, és ezek az eszközök nem küldenek origin‑t. A weboldalról csak a `/v1/public/*` és a `/v1/embed/*` útvonalakat tudja elérni.
</Aside>

## Kulcs az automatizáláshoz

Mindenki, aki szerkesztheti a Zap‑et, a szkriptet vagy a workflow‑t, látja a kulcsot belül. Ezért adj minden automatizációnak saját kulcsot, és korlátozd azt arra, amit csinál.

1. A vezérlőpulton nyisd meg az [API-kulcsok](https://api.astroway.info/dashboard/keys) és kattints a **Új kulcs** gombra. Nevezd el az automatizáció szerint, például `zapier-intake-form`.
2. A **Hol lesz használva ez a kulcs?** mezőben hagyd **Csak szerver** beállítást.
3. Másold ki a kulcsot. A párbeszédablak egyszer mutatja teljesen; később a **Megjelenítés** menüpontban érhető el a kulcs menüjében.
4. A kulcs menüjében nyisd meg a **Végpontok területe** részt, és sorold fel a soronként egy útvonalat, amelyet az automatizáció hív: `chart` a születési térképhez, `public/horoscope/*` a napi horoszkópokhoz.
5. Ugyanabban a menüben nyisd meg a **Költségkeret beállítása** részt, és add meg, hány kreditet használhat fel ez a kulcs egy ciklusban.

A listán kívüli hívás `403 ENDPOINT_NOT_IN_SCOPE` hibát kap. A költségkeretet kimerítő kulcs `429 KEY_BUDGET_EXHAUSTED` hibát kap, még akkor is, ha a fiókban még vannak kreditek, így a ciklusba került automatizáció leáll a megadott számnál. Mindkét korlátozás minden tarifán működik, és a [Hitelesítés](/authentication/) részben le van írva.

## Küldd el a születési pillanatot, ne az eltolást

Az űrlap dátumot, órát és helyet ad. Küldd el őket így:

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

- **`timezone`** a zóna neve, és a szerver önmagától megtalálja az UTC‑től való eltolást, amelyet az adott dátum órái mutattak, beleértve a nyári időt is. Kijev 1990‑05‑15‑én UTC+4‑en élte, nem +3‑at: ezt a hibát okozza a kézzel megadott eltolás. Küldj `auto`‑t, hogy a koordinátákból vegye a zónát.
- **`timezone` és eltolás nélkül** a térkép UTC‑re számít. A válasz továbbra is `200`, ezért ellenőrizd, hogy a mező párosítva van.
- **Üres `timezone`** `400` hibát ad, mert különben a kitöltetlen űrlapmező UTC‑ként lenne olvasva.
- **`date`** `YYYY‑MM‑DD` formátumban, **`time`** `HH:MM:SS` formátumban. Ha az űrlap másként tárolja őket, használd a dátumformázást az eszközben.
- **A számok szövegként is érkezhetnek.** `\"latitude\": \"50.45\"` elfogadott, és így küldik a legtöbb űrlapmező.
- **Az API nem geokódol.** A koordinátáknak az űrlapról vagy a geokódolási lépésből kell érkezniük az eszközben. A `city` mező csak címke.

Az órák és dátumok 1970 előtt történő átvitelének szabályai a [mezőformátumok](/agent-setup/field-formats/#timezone-назва-зони-замість-зсуву) részben vannak leírva.

## Hogyan alakítsd át a hosszúságot jelekké

`POST /v1/chart` fokban ad vissza a zodiák mentén, egy `{ "ok": true, "data": { ... } }` csomagban. A jel `floor(longitude / 30)` érték, nullától számítva:

0 Kos, 1 Bika, 2 Ikrek, 3 Rák, 4 Oroszlán, 5 Szűz, 6 Mérleg, 7 Skorpió, 8 Nyilas, 9 Bak, 10 Vízöntő, 11 Halak.

A három legnépszerűbb érték helye:

- **Nap**: bejegyzés a `data.planets`‑ben `"name": "Sun"` értékkel, első.
- **Hold**: bejegyzés a `data.planets`‑ben `"name": "Moon"` értékkel, második.
- **Ascenden**: `data.houses.ascendant`.
- **Használt eltolás**: `data.input.timezoneOffset`.

A fenti példához: Nap 54.34, tehát Bika; Hold 296.39, Bak; Ascenden 159.26, Szűz; eltolás 4.

## Mennyibe kerül

- `POST /v1/chart` 20 kreditet költ. A teljes táblázat a [Végpontok költsége](/credits/) oldalon található.
- Ugyanaz a kérés, ha újra elküldik öt percen belül, a cache‑ből jön vissza, és nem kerül levonásra. A teszt futtatás, amely ugyanazt a testet ismétli, nem fogyaszt költségkeretet.
- `GET /v1/public/horoscope/daily` nem fogyaszt krediteket. Kulcs nélkül vagy a Free tarifán lévő kulccsal óránként 30 kérés limitet számít IP‑címről, és az automatizációs platformok címét megosztják az ügyfelek között. A fizetős tarifán lévő kulcs saját limitet kap.