Engine REST API
390+ астрологических калькуляторов через REST — ведические, западные, эллинистические.
Engine REST API открывает доступ к 390+ астрологическим калькуляторам через простой POST-эндпоинт. Каждое имя калькулятора — точечный путь (например, vedic.yoga.engine, western.core.natal_chart). Передайте данные рождения или другие параметры в JSON-теле запроса и получите структурированный астрологический результат.
Base URL
https://engine.astrocodex.aiPOST /v1/calc/{name}Аутентификация
X-API-Key — Передайте Engine API ключ в заголовке X-API-Key.
OAuth 2.0 — Используйте OAuth 2.0 со скоупом "rest" для аутентификации от имени пользователя.
Что покрывает Engine API
390+ калькуляторов: ведические (йоги, даши, накшатры, панчанга, сахамы, доши…), западные (натальная карта, аспекты, достоинства, мидпоинты, фиксированные звёзды…), эллинистические и другие.
Единые соглашения об инпутах: latitude, longitude, timezone_offset, date — см. доку technique-input-conventions.
Встроенная i18n: именованные результаты уже содержат все четыре языка (name_en, name_ru, name_es, name_hi) — берите нужный. Каталоговые движки вроде yoga-движка также принимают поле «lang» в теле запроса.
Синастрия и совместимость через калькуляторы для двух карт — vedic.compat.* (synastry_aspects, ashtakuta…) и western.relations.* (synastry_full, composite_chart…), каждый вызывается по имени через /v1/calc/{name}.
Поиск калькуляторов
Не зашивайте имена калькуляторов — спросите у движка. GET /v1/calc возвращает весь каталог (каждый калькулятор с именем, системой и описанием); GET /v1/calc/{name}/meta — полную схему входных данных одного калькулятора (обязательные поля и типы). Оба запроса используют тот же заголовок X-API-Key, что и вызов расчёта.
GET /v1/calcGET /v1/calc/{name}/metaБольшинство калькуляторов возвращают каждое поле name сразу на четырёх языках — name_en, name_ru, name_es, name_hi — поэтому вы просто читаете нужный язык. Некоторые каталоговые движки (например vedic.yoga.engine) дополнительно принимают поле «lang» в теле JSON — «en» | «ru» | «es» | «hi» — чтобы вернуть один уже локализованный name и description.
POST /v1/calc/vedic.yoga.engine — { "lang": "es", … }Лимиты запросов в минуту и месячные квоты определяются B2B-тарифом в вашей подписке. Актуальные лимиты по тарифам — на странице тарифов.