Модули

Функции AstroAPI организованы в модули. Каждый модуль открывает доступ к определённым эндпоинтам API и функциональности для вашей организации.

Категории модулей

Категория	Описание
calc	Модули расчётов — вычислительные эндпоинты API
texts	Модули контента и текстов интерпретаций
charts	Модули визуализации карт
addon	Дополнительные функции
admin	Инструменты администрирования и управления

Доступные модули

ID модуля	Категория	Описание
module:natal	calc + texts + charts	Расчёты натальной карты, интерпретации и визуализация
module:natal-calc	calc	Только расчёты натальной карты
module:synastry	calc + texts + charts	Расчёты синастрии, интерпретации и карты
module:synastry-calc	calc	Только расчёты синастрии
module:transit	calc + texts + charts	Расчёты транзитов, интерпретации и карты
module:transit-calc	calc	Только расчёты транзитов
module:composite	calc + texts + charts	Расчёты композитной карты, интерпретации и карты
module:composite-calc	calc	Только расчёты композита
module:progression	calc	Вторичные прогрессии
module:solar-return	calc + texts + charts	Солярный возврат с интерпретациями и картами
module:solar-return-calc	calc	Только расчёты солярного возврата
module:lunar-return	calc + texts + charts	Лунный возврат с интерпретациями и картами
module:lunar-return-calc	calc	Только расчёты лунного возврата
module:chinese-horoscope	calc	Расчёт знака китайского зодиака
module:chinese-forecast	calc	Китайский годовой прогноз
module:compatibility	calc	Астрологическая совместимость
module:moon	calc	Расчёты Луны/Солнца и лунный календарь
module:retrograde	calc	Расчёты периодов ретроградности
module:numerology	calc	Расчёты нумерологии
module:daily-report	texts	Ежедневные гороскопы
module:weekly-report	texts	Еженедельные гороскопы
module:yearly-report	texts	Ежегодные гороскопы
module:yearly-ascendant-report	texts	Годовые гороскопы по асценденту
module:extra-language	addon	Поддержка дополнительных языков
module:ai-addon	addon	Функции AI-чатбота
module:embeddable-widgets	addon	Поддержка встраиваемых виджетов
module:content-editor	admin	Доступ к редактору контента

Тарифные планы

Каждый тарифный план включает фиксированный набор модулей. Все цены включают скидку 20%. Модули «Full» включают calc + texts + charts. Модули «Calc» включают только расчёты.

Функция	Basic (€49.99/мес)	Gold (€112.49/мес)	Premium (€249.99/мес)	Deluxe (€374.99/мес)
Ограничение запросов	60 зап./мин	120 зап./мин	300 зап./мин	600 зап./мин
Ежемесячных запросов	150К	300К	750К	1М
Натальная (calc)	✅	✅	✅	✅
Совместимость	✅	✅	✅	✅
Луна/Солнце	✅	✅	✅	✅
Нумерология	✅	✅	✅	✅
Редактор контента		✅	✅	✅
Натальная (full)		✅	✅	✅
Транзит (calc)			✅	✅
Солярный/Лунный возврат (calc)			✅	✅
Синастрия/Композит (calc)			✅	✅
Прогрессии			✅	✅
Китайский гороскоп			✅	✅
Ретроградность			✅	✅
Встраиваемые виджеты			✅	✅
Транзит (full)				✅
Солярный/Лунный возврат (full)				✅
Синастрия/Композит (full)				✅
Китайский прогноз				✅
Ежедневные/еженедельные/годовые отчёты				✅

Проверка доступа к модулям

Список всех модулей, доступных вашей организации:

curl -X GET "https://api.astroapi.cloud/api/modules" \
  -H "X-Api-Key: your-api-key"

Ответ

{
  "data": [
    {
      "type": "module",
      "id": "module:natal-calc",
      "attributes": {
        "name": "Natal Chart Calculations",
        "enabled": true,
        "expiresAt": null
      }
    },
    {
      "type": "module",
      "id": "module:transit-calc",
      "attributes": {
        "name": "Transit Calculations",
        "enabled": true,
        "expiresAt": "2024-12-31T23:59:59Z"
      }
    }
  ]
}

Эндпоинты с ограничением по модулям

При обращении к эндпоинту, требующему модуль, которого у вас нет:

{
  "errors": [{
    "status": "403",
    "title": "Module Required",
    "detail": "This endpoint requires the 'module:synastry-calc' module.",
    "meta": {
      "requiredModule": "module:synastry-calc"
    }
  }]
}

Разрешения API-ключа

API-ключи можно ограничить определёнными модулями. Даже если ваша организация имеет доступ к модулю, отдельные API-ключи могут быть настроены так, чтобы исключить его:

{
  "apiKey": {
    "modules": ["module:natal-calc", "module:moon"]
  }
}

Это позволяет создавать ключи с ограниченным доступом для конкретных сценариев использования — например, ключ, разрешающий только расчёты натальной карты без доступа к другим модулям, на которые подписана ваша организация.