The Numerology API v1.0.3¶

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

• 220+ документированных эндпоинтов по нумерологии, гороскопу, астрологии, совместимости, путешествиям, образованию, семейному наследию и инструментам дивинации
• Текущий релиз v1.0.3 с 10 новыми семействами расширенных эндпоинтов и полным покрытием ответов на 26 языках
• Публичный путь RapidAPI для быстрого прототипирования и подключения
• Прямой API + панель управления для продвинутой и корпоративной интеграции
• Готовая для разработчиков документация с примерами запросов, контрактами параметров и шаблонами ответов
• Дополнительный релиз v1.0.3 с 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.3¶

v1.0.3 добавляет знаки зодиака, полную настройку SVG-колеса натальной карты, перевод по запросу и Numora Studio v0.1.0-beta.

• Эндпоинты Солнца, Луны, Асцендента, Модальности и Элемента находятся в /api/v1/horoscope/sign/.
• planet: general — допустимая каноническая опция и значение по умолчанию для планетарных отчётов.
• /api/v1/birth-chart/svg принимает полный объект wheel для тем, палитр, макета, видимости, цветов планет, разделённого вывода и сжатия.
• LibreTranslate, Google Translate и DeepL BYOK выбираются для каждого запроса; провайдер указывается в метаданных.
• Numora Studio v0.1.0-beta доступен на macOS, Windows и Linux с отдельными ключами tnsr_.

→ Читать журнал изменений v1.0.3

Основные возможности 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, 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) на 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"

{
  "numerology_system": "pythagorean",
  "life_path_number": 8,
  "summary": {
    "title": "Life Path 8: The Powerhouse & Master Manifestor",
    "overview": "Life Path 8 carries the vibration of material mastery, authority, karmic balance, and large-scale achievement. You are the empire builder, financial wizard, and natural leader, gifted with exceptional organizational power, resilience, and the ability to manifest wealth and influence. Your soul purpose is to master power and use it responsibly for the greater good.",
    "strengths": [
      "Extraordinary business acumen, strategic thinking, and leadership",
      "Natural authority, executive presence, and resilience",
      "Ability to manifest large-scale wealth and influence",
      "Strong sense of justice and karmic awareness"
    ],
    "challenges": [
      "Power struggles, control issues, and workaholism",
      "Karmic lessons around money, ethics, and authority",
      "Fear of vulnerability or appearing weak",
      "Tendency to equate worth with material success"
    ],
    "life_lesson": "The greatest evolution for Life Path 8 is learning that true power is service-oriented and ethical. When authority is used to uplift others rather than dominate, abundance becomes infinite and meaningful.",
    "ideal_career_paths": [
      "Corporate leadership, entrepreneurship, and C-suite positions",
      "Finance, investment banking, real estate, and wealth management",
      "Politics, large-scale organization, and executive consulting",
      "Business coaching, strategic planning, and high-level management"
    ],
    "spiritual_growth_tip": "Practice generous philanthropy and ethical leadership. When you circulate wealth and power with wisdom and compassion, your success becomes truly divine."
  },
  "detailed_meaning": "Number 8 symbolizes power, ambition, and material success. Life Path 8 individuals are natural leaders, focused on achievement and financial mastery. They excel in business and management roles where their executive abilities shine. Born with an understanding of material world dynamics, they possess remarkable organizational and strategic skills. Their confidence and authority inspire others while their determination overcomes seemingly insurmountable obstacles. In relationships, they seek equal partners who appreciate their drive and share their ambitious vision. Career fulfillment comes through entrepreneurship, finance, real estate, corporate leadership, or large-scale ventures. Challenges include workaholism, authoritarian tendencies, and prioritizing material over spiritual; balancing material pursuits with spiritual growth, compassion, and personal relationships ensures true fulfillment and lasting legacy.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "9fe86d482c066afa",
    "quota": "unlimited",
    "usage_count": 1622,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "endpoint_description": "Calculates Life Path number from birth date.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-18T01:05:42.859507+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "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"
    ],
    "notes": ""
  }
}

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

• Направляйте категории только прямого доступа 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-справочник