Перейти к содержанию

Обзор API для создания гороскопов

Создавайте астрологические продукты на основе надежного движка, работающего на базе Swiss Ephemeris, предназначенного для приложений в производственной среде.

Качество движка Редакторская модель Режимы работы Язык отчетов

Этот API поддерживает два режима вывода с высокой ценностью:

  • Public mode для стабильного вывода на основе знаков, масштабируемого в больших объемах.
  • Personalized mode для редакторских отчетов, учитывающих данные о рождении, с более глубокими векторами (дома, аспекты, динамика времени).

Замечание: конечные точки движка, поддерживающие /api/v1/horoscope/reports/*, в настоящее время поддерживают только английский язык (lang=en). Конечные точки, не связанные с отчетами, могут поддерживать варианты языка для помощника-переводчика, если это указано.

Ясность ответа системы зодиака

При выборе zodiac_system: "tropical" расчет отчета остается тропическим. При выборе zodiac_system: "sidereal" расчет отчета остается сидериальным.

Если в теле запроса не указано zodiac_system, движок по умолчанию использует tropical.

Несмотря на выбранный режим, вы все равно можете видеть поля, связанные с тропическим, сидериальным и аянсамским календарями, в метаданных ответа. Эти поля возвращаются только для сравнения, обеспечения прозрачности и мониторинга. Они не влияют на фактические расчеты отчета для выбранной системы зодиака.

Ежедневные статистические данные UI

Основные ежедневные персонализированные конечные точки предоставляют богатые, удобные для пользовательского интерфейса, статистические данные в data.daily_personalized_stats.

Статистика UI Активация Данные Наборы графиков

Персонализированные ежедневные статистические данные включают:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence уровней на блок

Используйте daily_stats_detail: "full" | "compact" для управления плотностью данных для мобильных/веб-клиентов.

Архитектура

Полная архитектура движка

Полная архитектура движка зодиака

Архитектура "Запрос - Ответ"

Архитектура "Запрос - Ответ" для зодиака

Разбор по времени выполнения

Производственная система зодиака следует детерминированной последовательности:

  1. API Gateway проверяет аутентификацию, лимиты и политику запросов.
  2. Приложение FastAPI проверяет контракт и выполняет проверку кэша.
  3. HoroscopeService определяет знак, период, конфигурацию эфемериды и режим.
  4. EphemerisEngine вычисляет положения, аспекты, дома и восходящий знак.
  5. AggregationEngine извлекает события периода, метрики и ранжированные факторы.
  6. InterpretationEngine отображает комбинации факторов на выходные данные с отслеживаемостью.
  7. Ответ собирается, оборачивается метаданными и кэшируется.

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

Модель доверия: Закрытый ядро + Легковесный Open Source

Наш основной движок является закрытым источником и оптимизирован для отчетов с высокой степенью определенности, премиальных редакционных слоев и надежной работы в производственной среде.

Для повышения прозрачности и доверия разработчиков мы также поддерживаем надежный легкий open-source движок:

Используйте OpAstro для быстрого оценки качества движка, а затем масштабируйте до корпоративных маршрутов NumerologyAPI для более глубоких отчетов, более широкого покрытия конечных точек и управляемых операций в производственной среде.

Начните здесь

Быстрый старт: Персонализированный ежедневный отчет + Статистика приложения

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16",
  "timezone": "America/New_York",
  "birth_time": "13:45",
  "birth_latitude": 40.7128,
  "birth_longitude": -74.0060,
  "birth_timezone": "America/New_York",
  "daily_stats_detail": "compact"
}'

Этот запрос возвращает текущий ежедневный отчет, а также data.daily_personalized_stats для карточек и модулей трендов приложения.

Руководство по выбору маршрутов

Цель Рекомендуемая семейство конечных точек
Общий ежедневный отчет, основанный на знаке зодиака /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday
Персонализированный ежедневный отчет + карточки со статистикой приложения Основные маршруты для ежедневного отчета с birth_time, координатами и daily_stats_detail
Периодические общие отчеты /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly
Отчеты для конкретных разделов (карьера, здоровье, финансы, общение, дружба, образ жизни, любовь) Маршруты по разделам
Редакционные отчеты, ориентированные на планеты Маршруты по планетам
Редакционные отчеты, ориентированные на аспекты Маршруты по аспектам
Редакционные отчеты, ориентированные на транзиты Маршруты по транзитам
Персонализированные отчеты для дома Маршруты по домам
Персонализированные отчеты, ориентированные на планету и дом Маршруты по планете и дому
Полная натальная карта + артефакты колеса Маршруты для натальной карты

Карта конечных точек

Используйте эту карту, чтобы быстро перейти к необходимому семейству маршрутов для вашей продукции.

Натальная карта и основы

Ежедневный гороскоп

Еженедельный гороскоп

Ежемесячный гороскоп

Годовой гороскоп

Гороскоп для любви

Отчеты о планетах, аспектах, транзитах и домах

Описания знаков зодиака (Не живые отчеты)

Эти /api/v1/horoscope/sign/* конечные точки возвращают описательные значения архетипов знаков, а не живые астрологические отчеты. Используйте /api/v1/horoscope/reports/* для генерации живых отчетов.

Совместимость и Энциклопедия

Лучше всего подходит для

  • Мобильных и веб-приложений, связанных с астрологией
  • Персонализированных ежедневных отчетов и новостных рассылок
  • Продуктов совместимости и отношений
  • Дашбордов для здоровья, коучинга и духовности
  • Интеграций для предприятий, требующих детерминированной повторяемости

Разработано компанией NumerologyAPI.com