The Numerology API v1.0.2¶

The Numerology API — это производственная платформа для создания нумерологических и астрологических продуктов с детерминированными результатами, структурированными JSON-контрактами и широким покрытием эндпоинтов.

• 220+ документированных эндпоинтов по нумерологии, гороскопу, астрологии, совместимости, путешествиям, образованию, семейному наследию и инструментам дивинации
• Текущий релиз v1.0.2 с 10 новыми семействами расширенных эндпоинтов и полным покрытием ответов на 26 языках
• Публичный путь RapidAPI для быстрого прототипирования и подключения
• Прямой API + панель управления для продвинутой и корпоративной интеграции
• Готовая для разработчиков документация с примерами запросов, контрактами параметров и шаблонами ответов
• Дополнительный релиз v1.0.2 с 10 новыми семействами прямых API-эндпоинтов для вех отношений, переезда, транспортных средств, соответствия номера телефона, подписей, питомцев, творческих проектов, семейного наследия, образовательных путей и согласования направлений путешествий
• 26 поддерживаемых языков ответов: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
• Мультисистемная нумерология через num_sys: pythagorean, chaldean и vedic

Основные возможности v1.0.2¶

v1.0.2 — это дополнительный производственный релиз для Numerology API. Он расширяет выпущенный v1.0.1 с мультисистемной поддержкой и 8 языками, добавляя 10 новых семейств расширенных эндпоинтов и расширяя поддержку языков ответов до 26.

Этот релиз фокусируется на четырёх основных целях:

1. Новое покрытие расширенных эндпоинтов
2. Добавляет 10 новых семейств эндпоинтов.
3. Каждый новый эндпоинт поддерживает как GET, так и POST.
4. Все новые эндпоинты используют чистые публичные маршруты по адресу /api/v1/*.
5. Новые семейства эндпоинтов включают вехи отношений, переезд, идентичность транспортных средств, соответствие номера телефона, подписи, питомцев, творческие проекты, семейное наследие, образовательные пути и согласование направлений путешествий.

1. Продолжение мультисистемной нумерологии
2. Новые эндпоинты на основе имени/названия/текста поддерживают опциональный num_sys.
3. Поддерживаемые системы:
   • pythagorean
   • chaldean
   • vedic

4. pythagorean остаётся системой по умолчанию для сохранения существующего поведения.

5. Расширенное языковое покрытие

6. v1.0.1 остаётся выпущенным рубежом с 8 языками:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja
7. v1.0.2 добавляет 18 дополнительных языков:
   • ru
   • tr
   • it
   • pl
   • nl
   • id
   • ko
   • th
   • ro
   • ur
   • gu
   • bn
   • vi
   • ta
   • te
   • mr
   • pa
   • zh

8. Новые семейства эндпоинтов включают локализованные JSON-файлы значений во всех 26 поддерживаемых языковых директориях.

9. Готовность документации и релиза

10. Добавляет документацию по интеграции для всех 10 новых семейств эндпоинтов.
11. Добавляет журнал изменений v1.0.2.
12. Обновляет индекс расширенных эндпоинтов и ссылки на релизы API-справочника.
13. Отображает новые эндпоинты во внутренней документации панели управления и в поиске команд.
14. Проверяет видимость маршрутов, покрытие JSON, структуру локализованных значений и стабильность тестового набора с Python 3.11.

→ Читать полный журнал изменений v1.0.2

Основные возможности v1.0.1¶

v1.0.1 — это дополнительный производственный релиз для Numerology API. Он расширяет выпущенный v1.0.0 с расширенными нумерологическими расчётами, добавляя более глубокие чтения имени, времени, бизнеса, решений, семьи, команды, денег и архетипов.

Этот релиз фокусируется на четырёх основных целях:

1. Более широкое покрытие эндпоинтов
2. Добавляет 10 новых семейств эндпоинтов.
3. Каждый новый эндпоинт поддерживает как GET, так и POST.

4. Все новые эндпоинты используют чистые публичные маршруты по адресу /api/v1/*.

5. Мультисистемная нумерология

6. Новые эндпоинты на основе имени поддерживают опциональный num_sys.
7. Поддерживаемые системы:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean остаётся системой по умолчанию для сохранения существующего поведения.

9. Расширенное языковое покрытие

10. Поддерживаемые языки ответов теперь включают:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. 10 новых семейств эндпоинтов включают локализованные JSON-файлы значений для всех 8 поддерживаемых языков.

12. Готовность документации и релиза

13. Добавляет документацию по интеграции для всех 10 новых семейств эндпоинтов.
14. Обновляет индекс расширенных эндпоинтов.
15. Документирует поведение GET, POST, lang и num_sys.
16. Проверяет видимость маршрутов, покрытие JSON и стабильность тестового набора с Python 3.11.

→ Читать полный журнал изменений v1.0.1

Основные возможности v1.0.0¶

Этот релиз объединяет два основных направления в одну версию платформы:

1. Развёртывание расширенной нумерологии
2. Добавлено 23 новых семейства эндпоинтов и 41 новая операция GET/POST.
3. Добавлены новые категории: Identity & Name, Spiritual & Shadow и Relationship.
4. Расширено покрытие временных аспектов с маршрутами личной недели и универсального дня/недели/месяца/года.

5. Проверено мультиязычное покрытие (en, es, de, fr, pt) на 100% в QA релиза.

6. Миграция и расширение движка гороскопов

7. Добавлено 53+ новых эндпоинта со стандартизированной канонической маршрутизацией отчётов по адресу /api/v1/horoscope/reports/*.
8. Расширены семейства ежедневных/еженедельных/ежемесячных/ежегодных отчётов и специализированные наборы (планетарные, аспекты, транзиты, дома, планеты-дома).
9. Улучшена согласованность запросов/ответов и паритет маршрутов для производственных интеграций.

→ Читать полный журнал изменений v1.0.0 → Читать архитектуру движка гороскопов

Пути доступа¶

Карта API-справочника¶

• Обзор API-справочника
• Базовые эндпоинты
• Циклы и транзиты
• Идентичность и имя
• Духовные и теневые аспекты
• Отношения
• Мостовые эндпоинты
• Кармические эндпоинты
• Эндпоинты гороскопа
• Прочие эндпоинты (Таро / Гематрия)

Движок гороскопов (производственная модель)¶

Стек гороскопов является детерминированным и основан на Swiss Ephemeris, разработан для реального производственного поведения (стабильные результаты, воспроизводимое QA и кеш-дружественный дизайн маршрутов).

• Детерминированные стеки факторов по периодам (ежедневно, еженедельно, ежемесячно, ежегодно)
• Публичный режим (на основе знаков) и персонализированный режим (с учётом данных рождения)
• Наборы отчётов помимо общего гороскопа: планетарные, аспекты, транзиты, дома, планеты-дома
• Корпоративные обёртки в ответах (_enterprise, _api_metadata_) для операционных метаданных

→ Глубокое погружение в движок → Обзор отчётов гороскопа

Быстрый старт¶

Прямой API (рекомендуется для расширенного покрытия)¶

curl "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

Расширенный эндпоинт прямого API v1.0.2¶

curl "https://api.numerologyapi.com/api/v1/relationship-milestone-numerology?person_a_name=Amina%20Bello&person_a_dob=1992-04-18&person_b_name=Jonas%20Meyer&person_b_dob=1990-11-06&milestone_date=2027-06-12&milestone_type=wedding&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: YOUR_API_KEY"

RapidAPI (публичный маршрут)¶

curl "https://the-numerology-api.p.rapidapi.com/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

Форма ответа (пример)¶

{
  "life_path_number": 3,
  "summary": {
    "title": "Life Path 3",
    "overview": "Creative, expressive, and socially magnetic energy pattern."
  },
  "_enterprise": {
    "client": "The Numerology API"
  },
  "_api_metadata_": {
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

Заметки по миграции для существующих интеграций¶

• Направляйте категории только прямого доступа v1.0.2 на https://api.numerologyapi.com.
• Предпочитайте POST для более насыщенных/вложенных контрактов запросов, где это доступно.
• Используйте lang на поддерживаемых маршрутах прямого API для локализованных JSON-значений на 26 языках.
• Используйте num_sys на маршрутах нумерологии на основе имени/названия/текста, когда вам нужны расчёты pythagorean, chaldean или vedic.
• Нормализуйте ввод дат и месяцев (YYYY-MM-DD, YYYY-MM).
• Последовательно обрабатывайте _enterprise и _api_metadata_ в ваших клиентских моделях.
• Для продуктов гороскопов переходите на канонические эндпоинты /api/v1/horoscope/reports/*.

Интеграция с плагином WordPress¶

Нужен путь без кода для доставки на сайт? Используйте официальный плагин Dakidarts Numerology Core для встраивания форм, чтений и отчётов непосредственно на страницы WordPress.

• Документация плагина
• Установить с WordPress.org

Следующие шаги¶

• Начало работы
• Ценообразование
• Примеры
• Журнал изменений
• API-справочник