Перейти до вмісту
AstroWay/api v2.190.0 · integrations
усі системи в нормі

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

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

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

  • Zapier, Make і n8n надсилають його зі своїх серверів. Потрібен ключ «Тільки сервер» з областю ендпоінтів і бюджетом, як описано нижче. Інструкції: Zapier, Make, n8n.
  • Bubble теж надсилає запити зі своїх серверів, а ключ лежить у заголовку, який там і лишається: Bubble.
  • FlutterFlow компілюється в застосунок, який тримає користувач, тож виклик треба робити приватним: FlutterFlow.
  • Wix, Squarespace, Shopify, Webflow і Tilda показують сторінку в браузері відвідувача. Вставляйте віджет, а не ключ: конструктори сайтів.
  • WordPress звертається з вашого власного сервера. Ключем опікується плагін AstroWay.

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

Section titled “Ключ для автоматизації”

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

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

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

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

Section titled “Надсилайте момент народження, а не зсув”

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

{
"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 року описані у форматах полів.

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

Section titled “Як перетворити довготи на знаки”

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 кредитів. Повна таблиця на сторінці Вартість ендпоінтів.
  • Той самий запит, надісланий знову протягом п’яти хвилин, повертається з кешу й не списується. Тестовий запуск, що повторює одне тіло, бюджет не витрачає.
  • GET /v1/public/horoscope/daily кредитів не витрачає. Без ключа або з ключем на тарифі Free він рахується в ліміт 30 запитів на годину з IP-адреси, а платформи автоматизації ділять свої адреси між клієнтами. Ключ на платному тарифі має власний ліміт.
Корисно?
Запропонувати правку

Останнє оновлення: