# Integrace bez kódu

Vše na těchto stránkách bylo otestováno proti produkci 2026-09-17. Workflow pro n8n byl importován a spuštěn v skutečném n8n; kroky pro Zapier a Make byly napsány podle vlastní dokumentace těchto nástrojů a požadavky, které sestavují, byly odeslány přesně v této podobě.

## Odkud pochází požadavek

- **Zapier, Make и n8n** posílají jej ze svých serverů. Potřebný je klíč „Pouze server“ s oborem endpointů a rozpočtem, jak je popsáno níže. Pokyny: [Zapier](/integrations/zapier/), [Make](/integrations/make/), [n8n](/integrations/n8n/).
- **Bubble** také odesílá požadavky ze svých serverů a klíč je v hlavičce, která tam zůstává: [Bubble](/integrations/bubble/).
- **FlutterFlow** se kompiluje do aplikace, kterou uživatel drží, takže volání musí být prováděno soukromě: [FlutterFlow](/integrations/flutterflow/).
- **Wix, Squarespace, Shopify, Webflow a Tilda** zobrazují stránku v prohlížeči návštěvníka. Vložte widget, nikoli klíč: [konstruktory webových stránek](/integrations/site-builders/).
- **WordPress** se připojuje z vašeho vlastního serveru. Klíč se stará o [plugin AstroWay](https://wordpress.org/plugins/astroway/).

<Aside type="caution">
Veřejný klíč `pk_` nefunguje s Zapierem, Make ani n8n. Odmítá požadavek bez původu ze svého seznamu, a tyto nástroje původ neodesílají. Ze stránky webu získá pouze `/v1/public/*` a `/v1/embed/*`.
</Aside>

## Klíč pro automatizaci

Každý, kdo může upravovat Zap, scénář nebo workflow, vidí klíč uvnitř. Proto dejte každé automatizaci vlastní klíč a omezte jej tím, co dělá.

1. Na dashboardu otevřete [API klíče](https://api.astroway.info/dashboard/keys) a klikněte na **Nový klíč**. Pojmenujte jej podle automatizace, například `zapier-intake-form`.
2. V poli **Kde bude tento klíč používán?** nechte **Pouze server**.
3. Zkopírujte klíč. Dialog ho zobrazí celý jen jednou; později je dostupný přes **Zobrazit** v nabídce klíče.
4. V nabídce klíče otevřete **Obor endpointů** a vypište cesty, které automatizace volá, po jednom na řádek: `chart` pro natální kartu, `public/horoscope/*` pro denní horoskopy.
5. Ve stejné nabídce otevřete **Nastavit rozpočet** a uveďte, kolik kreditů může tento klíč utratit za cyklus.

Volání mimo seznam obdrží `403 ENDPOINT_NOT_IN_SCOPE`. Klíč, který vyčerpal rozpočet, obdrží `429 KEY_BUDGET_EXHAUSTED`, i když na účtu ještě jsou kredity, takže automatizace, která se zapetla, se zastaví na uvedeném čísle. Oba omezení fungují na jakémkoli tarifu a jsou popsána v sekci [Authentizace](/authentication/).

## Odesílejte okamžik narození, nikoli posun

Formulář poskytuje datum, čas na hodinkách a místo. Odesílejte je takto:

```json
{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}
```
- **`timezone`** je název zóny a server sám najde posun od UTC, který měly hodinky toho dne, včetně letního času. Praha 1990-05-15 žila v UTC+4, nikoli +3: právě tuto chybu způsobuje ručně zadávaný posun. Odešlete `auto`, abyste vzali zónu ze souřadnic.
- **Bez `timezone` a bez posunu** se mapa počítá pro UTC. Odpověď je stále `200`, takže zkontrolujte, že je pole nastaveno.
- **Prázdné `timezone`** je odmítnuto s `400`, protože jinak by prázdné pole formuláře bylo čteno jako UTC.
- **`date`** ve formátu `YYYY-MM-DD`, **`time`** ve formátu `HH:MM:SS`. Pokud formulář ukládá jinak, použijte formátování data v samotném nástroji.
- **Čísla mohou přijít jako text.** `"latitude": "50.45"` je přijato, a právě tak je odesílá většina polí formulářů.
- **API neprovádí geokódování.** Souřadnice musí přijít z formuláře nebo z kroku geokódování v nástroji. Pole `city` je pouze popisek.

Pravidla pro převod hodinek a dat před rokem 1970 jsou popsána v [formátech polí](/agent-setup/field-formats/#timezone-název-zóny-místo-posunu).

## Jak převést délku na znamení

`POST /v1/chart` odpovídá ve stupních podél zvěrokruhu, v obálce `{ "ok": true, "data": { ... } }`. Znak se rovná `floor(longitude / 30)`, počítáno od nuly:

0 Beran, 1 Býk, 2 Blíženci, 3 Rak, 4 Lev, 5 Panna, 6 Váhy, 7 Štír, 8 Střelec, 9 Kozoroh, 10 Vodnář, 11 Ryby.

Kde se nacházejí tři nejpopulárnější hodnoty:

- **Slunce**: záznam v `data.planets` s `"name": "Sun"`, první.
- **Měsíc**: záznam v `data.planets` s `"name": "Moon"`, druhý.
- **Ascendent**: `data.houses.ascendant`.
- **Použitý posun**: `data.input.timezoneOffset`.

Pro výše uvedený příklad: Slunce 54.34, tedy Býk; Měsíc 296.39, tedy Kozoroh; Ascendent 159.26, tedy Panna; posun 4.

## Kolik to stojí

- `POST /v1/chart` stojí 20 kreditů. Úplná tabulka na stránce [Cena endpointů](/credits/).
- Ten stejný požadavek, odeslaný znovu během pěti minut, se vrátí z mezipaměti a nebude se účtovat. Testovací spuštění, které opakuje jedno tělo, nevyčerpá rozpočet.
- `GET /v1/public/horoscope/daily` neúčtuje žádné kredity. Bez klíče nebo s klíčem na tarifu Free se počítá do limitu 30 požadavků za hodinu z IP adresy, a platformy automatizace dělí své adresy mezi klienty. Klíč na placeném tarifu má vlastní limit.
