Account REST API
REST-эндпоинты для ваших карт, техник, транзитов и синастрии — те же, что у приложений. Аутентификация: X-API-Key. Доступно на всех тарифах, включая бесплатный (с пониженными лимитами).
Account REST API даёт вашему приложению программный доступ к сохранённым картам пользователя, результатам техник, транзитам и синастрии — те же эндпоинты, что используют веб- и мобильное приложения AstroCodex. Аутентификация — Account API ключом в заголовке X-API-Key; доступно на всех тарифах, включая бесплатный (с пониженными лимитами) — платные тарифы повышают лимиты запросов и месячные квоты. Ответы — в формате JSON. (Нужен вход по OAuth без ключа для ИИ-ассистента? Используйте Account MCP.)
Аутентификация
X-API-Key header — Передайте Account API ключ в заголовке X-API-Key.
Доступ по тарифу — Доступно на всех тарифах, включая бесплатный (с пониженными лимитами); платные тарифы повышают лимиты запросов и месячные квоты. (Хотите вход без ключа? OAuth доступен на поверхности Account MCP.)
Base URL
https://api.astrocodex.aiОсновные эндпоинты
/api/meПрофиль авторизованного пользователя и его текущий тариф./api/natal-chartsСписок сохранённых натальных карт пользователя./api/natal-chartsСоздать новую карту и рассчитать её./api/natal-charts/{publicId}Прочитать карту по public id — полные вычисленные данные и реестр техник./api/natal-charts/{publicId}Изменить имя или данные рождения карты и пересчитать её./api/natal-charts/{publicId}Удалить одну из карт пользователя./api/natal-charts/{publicId}/transitsТекущие или датированные транзиты для сохранённой карты./api/synastry/calculateСинастрия / совместимость между двумя картами.Базовый набор — те же маршруты, что используют приложения AstroCodex. Чтение одной карты (GET …/{publicId}) возвращает все её вычисленные данные — планеты, дома и весь реестр натальных техник. На той же базе /api доступны также пересчёт карты, AI-обзоры, публичный доступ и полное управление синастрией.
Вызовы Account REST тарифицируются как запросы и доступны на всех тарифах, включая бесплатный (платные тарифы повышают лимиты и квоты); при этом токены AstroCodex не расходуются. (Токены тратит только собственный встроенный ИИ-чат AstroCodex, и это отдельно от этого API.)