Як ми будуємо API.
Внутрішня кухня, постмортеми та архітектурні рішення. Усе те, що ми хотіли б прочитати самі, до того, як розбиратися болем.
Нумерологія в API: 5 систем розрахунку за одним маршрутом
Більшість API або взагалі не мають нумерології, або дають одну піфагорійську систему. У нас 5 повних систем (піфагорійська, халдейська, дві кабалістичні, ведична) по 10 розрахунків кожна, за одним параметризованим маршрутом. Плюс Матриця Долі на 22 аркани.
Карта каталогу: як влаштовані 700+ ендпоінтів AstroWay
API виріс до понад 700 ендпоінтів у 57 групах - від натальної карти до BaZi, геомантії та рендеру SVG-карт. Розбираємо, як каталог поділений на домени, за яким єдиним патерном ходять усі виклики і як швидко знайти потрібний ендпоінт.
Три офіційні SDK: TypeScript, Python, PHP замість сирого curl
Сирий HTTP працює, але типізований клієнт економить години: автодоповнення шляхів, типи запиту й відповіді, вбудований retry на 408/409/429/5xx і Stainless-style ієрархія помилок. Розбираємо три офіційні SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - і чим вони згенеровані з одного OpenAPI-контракту.
X-Cache header: видимий cache-status для оптимізації клієнтських інтеграцій
Кожна response API тепер несе X-Cache: MISS | HIT | BYPASS - клієнт відразу бачить чи запит обчислений з нуля, чи витягнутий з кешу. Це відкриває cache hit % колонку в /dashboard/usage та дозволяє оптимізувати інтеграцію без guesswork.
Reports V2: один ендпоінт замість дванадцяти - `/v1/reports/generate`
Замість 12 type-specific роутів /reports/natal, /reports/synastry, … - один уніфікований ендпоінт POST /v1/reports/generate з полем report_type. SDK-консументи отримують один метод замість дванадцяти; MCP-каталог скорочується з 12 інструментів до одного.
Vedic-астрологія через API: від Парашари до Лал Кітаб у 354 ендпоінтах
AstroWay тепер пропонує найповніше Vedic-покриття серед комерційних API: 10 систем дешів, 16 варг, Панчанг, повний Лал Кітаб + КП + Джайміні. Як це працює і коли яку техніку обирати.
White-label PDF без WordPress: inline branding через одне поле
Поле whitelabel у схемах усіх 12 ендпоінтів /v1/reports/* тепер приймає не лише boolean (читати DB-конфіг), а й inline-об'єкт з 15 полями. Це знімає прив'язку до WordPress-користувача - будь-який SaaS-консумент API може брендувати PDF на льоту, без okремої admin-сторінки.
Як збудувати астрологічний застосунок: повний путівник для розробника
Покроковий гайд зі створення астрологічного застосунку з нуля - вибір API, архітектура, перша натальна карта, додавання синастрії та транзитів, деплой.
Швидкий старт API астрології: TypeScript і Python за 5 хвилин
Встановити SDK, отримати API-ключ, зробити перший запит натальної карти. 5 хвилин - і робочий JSON на руках (TypeScript і Python).
Rectification API: корекція часу народження для розробників
Ректифікація - це процес уточнення невідомого або неточного часу народження за подіями життя. У цьому пості - як автоматизувати її через API з використанням алгоритмічного методу та Trutine of Hermes.
Той самий Swiss Ephemeris, що й у Solar Fire - у 4 рядках коду.
Безкоштовний ключ без картки. 5 000 викликів на місяць до першої оплати.