# Інтеграції без коду

Усе на цих сторінках виконано проти продакшену 2026-09-17. Workflow для n8n імпортовано й запущено в справжньому n8n; кроки для Zapier і Make написані за власною документацією цих інструментів, а запити, які вони складають, надіслано саме в такому вигляді.

## Звідки йде запит

Від цього залежить, який ключ потрібен.

- **Zapier, Make і n8n** надсилають його зі своїх серверів. Потрібен ключ «Тільки сервер» з областю ендпоінтів і бюджетом, як описано нижче. Інструкції: [Zapier](/integrations/zapier/), [Make](/integrations/make/), [n8n](/integrations/n8n/).
- **Bubble** теж надсилає запити зі своїх серверів, а ключ лежить у заголовку, який там і лишається: [Bubble](/integrations/bubble/).
- **FlutterFlow** компілюється в застосунок, який тримає користувач, тож виклик треба робити приватним: [FlutterFlow](/integrations/flutterflow/).
- **Wix, Squarespace, Shopify, Webflow і Tilda** показують сторінку в браузері відвідувача. Вставляйте віджет, а не ключ: [конструктори сайтів](/integrations/site-builders/).
- **WordPress** звертається з вашого власного сервера. Ключем опікується [плагін AstroWay](https://wordpress.org/plugins/astroway/).

<Aside type="caution">
Публічний ключ `pk_` не працює з Zapier, Make чи n8n. Він відхиляє запит без origin зі свого списку, а ці інструменти origin не надсилають. Зі сторінки сайту він дістає лише `/v1/public/*` і `/v1/embed/*`.
</Aside>

## Ключ для автоматизації

Кожен, хто може редагувати Zap, сценарій чи workflow, бачить ключ усередині. Тому дайте кожній автоматизації власний ключ і обмежте його тим, що вона робить.

1. У дашборді відкрийте [API-ключі](https://api.astroway.info/dashboard/keys) і натисніть **Новий ключ**. Назвіть його за автоматизацією, наприклад `zapier-intake-form`.
2. У полі **Де буде використовуватись цей ключ?** залиште **Тільки сервер**.
3. Скопіюйте ключ. Діалог показує його повністю один раз; пізніше він доступний через **Показати** в меню ключа.
4. У меню ключа відкрийте **Область ендпоінтів** і перелічіть шляхи, які викликає автоматизація, по одному в рядку: `chart` для натальної карти, `public/horoscope/*` для щоденних гороскопів.
5. У тому ж меню відкрийте **Задати бюджет** і вкажіть, скільки кредитів цей ключ може витратити за цикл.

Виклик поза списком отримує `403 ENDPOINT_NOT_IN_SCOPE`. Ключ, що вичерпав бюджет, отримує `429 KEY_BUDGET_EXHAUSTED`, навіть коли на акаунті ще є кредити, тож автоматизація, яка зациклилася, зупиниться на вказаному числі. Обидва обмеження працюють на будь-якому тарифі й описані в розділі [Автентифікація](/authentication/).

## Надсилайте момент народження, а не зсув

Форма дає дату, час на годиннику і місце. Надсилайте їх так:

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

- **`timezone`** це назва зони, і сервер сам знаходить зсув від UTC, який тримали годинники тієї дати, разом із літнім часом. Київ 1990-05-15 жив за UTC+4, а не +3: саме таку помилку дає зсув, введений вручну. Надішліть `auto`, щоб узяти зону з координат.
- **Без `timezone` і без зсуву** карта рахується для UTC. Відповідь усе одно `200`, тож перевірте, що поле зіставлене.
- **Порожній `timezone`** відхиляється з `400`, бо інакше незаповнене поле форми читалося б як UTC.
- **`date`** у форматі `YYYY-MM-DD`, **`time`** у форматі `HH:MM:SS`. Якщо форма зберігає їх інакше, скористайтеся форматуванням дати в самому інструменті.
- **Числа можуть приходити текстом.** `"latitude": "50.45"` приймається, а саме так їх надсилає більшість полів форм.
- **API не геокодує.** Координати мають прийти з форми або з кроку геокодування в інструменті. Поле `city` лише підпис.

Правила для переведення годинників і дат до 1970 року описані у [форматах полів](/agent-setup/field-formats/#timezone-назва-зони-замість-зсуву).

## Як перетворити довготи на знаки

`POST /v1/chart` відповідає в градусах уздовж зодіаку, у обгортці `{ "ok": true, "data": { ... } }`. Знак дорівнює `floor(longitude / 30)`, рахуючи від нуля:

0 Овен, 1 Телець, 2 Близнюки, 3 Рак, 4 Лев, 5 Діва, 6 Терези, 7 Скорпіон, 8 Стрілець, 9 Козеріг, 10 Водолій, 11 Риби.

Де лежать три найпопулярніші значення:

- **Сонце**: запис у `data.planets` з `"name": "Sun"`, перший.
- **Місяць**: запис у `data.planets` з `"name": "Moon"`, другий.
- **Асцендент**: `data.houses.ascendant`.
- **Використаний зсув**: `data.input.timezoneOffset`.

Для прикладу вище: Сонце 54.34, отже Телець; Місяць 296.39, Козеріг; Асцендент 159.26, Діва; зсув 4.

## Скільки це коштує

- `POST /v1/chart` коштує 20 кредитів. Повна таблиця на сторінці [Вартість ендпоінтів](/credits/).
- Той самий запит, надісланий знову протягом п'яти хвилин, повертається з кешу й не списується. Тестовий запуск, що повторює одне тіло, бюджет не витрачає.
- `GET /v1/public/horoscope/daily` кредитів не витрачає. Без ключа або з ключем на тарифі Free він рахується в ліміт 30 запитів на годину з IP-адреси, а платформи автоматизації ділять свої адреси між клієнтами. Ключ на платному тарифі має власний ліміт.