API — Быстрый старт

Cosmic Modules API — REST API с JSON-ответами. Базовый URL: 

https://api.cosmicmodules.com

Аутентификация

Все запросы к API требуют ключа. Передайте его в заголовке X-API-Key: 

X-API-Key: ваш_ключ_api

Пример с curl:

curl https://api.cosmicmodules.com/api/v1/charts/natal \
  -H "X-API-Key: ваш_ключ_api" \
  -H "Content-Type: application/json" \
  -d '{"local_birth_datetime":"1990-06-15T14:30:00","location":{"latitude":55.75,"longitude":37.62,"place_name":"Москва"},"house_system":"whole_sign"}'

При неверном ключе API вернёт 401 Unauthorized. Убедитесь, что заголовок передаётся точно как X-API-Key.

Эндпоинты

POST /api/v1/charts/natal
GET /api/v1/charts/{chart_id}
GET /api/v1/charts/{chart_id}/nakshatra-synthesis
GET /api/v1/charts/vimshottari
GET /api/v1/charts/vimshottari/{vimshottari_id}/interpretations

Типичный сценарий

  1. Отправьте POST /api/v1/charts/natal с данными рождения — получите chart_id.
  2. Запросите GET /api/v1/charts/{chart_id} — Western-карта (планеты, аспекты, дома).
  3. Запросите GET /api/v1/charts/{chart_id}/nakshatra-synthesis — Vedic накшатры.
  4. Запросите GET /api/v1/charts/vimshottari — список Вимшоттари-карт.
  5. Запросите интерпретации даш по vimshottari_id.

Подробный справочник: Натальная карта →