Расширение Numerology + Расширение Horoscope v1.0.0 Объединенный журнал изменений¶
Дата выпуска: 2026-04-12 Версия: v1.0.0 Область применения: Полный выпуск платформы, охватывающий Numerology API, Расширение Horoscope: включая развертывание расширенных конечных точек, миграцию отчетов о прогнозировании на основе движка, нормализацию запросов/ответов, соответствие документации, многоязычную валидацию и рекомендации по интеграции в производство.
Обзор¶
v1.0.0 – это крупный выпуск для платформы Dakidarts API. Он объединяет две крупные линии разработки в единое скоординированное развертывание:
- Расширение Numerology
- Добавляет полную расширенную поверхность numerology.
- Расширяет покрытие времени/цикла, включая личную неделю и универсальный день/неделю/месяц/год.
- Вводит более глубокие конечные точки для анализа духовности, отношений, идентичности и "темных сторон".
- Завершает соответствие документации, примеры ответов и многоязычную валидацию.2. Расширение функциональности прогнозирования
- Завершает основную миграцию генерации отчетов о прогнозах на использование внутреннего движка Swiss Ephemeris.
- Стандартизирует маршруты для создания отчетов, поддерживаемых движком, под
/api/v1/horoscope/reports/*. - Обеспечивает широкий охват различных периодов: ежедневные, еженедельные, месячные и годовые.
- Вводит наборы отчетов о планетах, аспектах, транзитах и домах в зависимости от периода.
- Улучшает согласованность данных, поведение персонализации, совместимость и соответствие документации.
Этот журнал изменений предназначен для использования как единственный источник информации для интеграторов, внутреннего обзора развертывания, поддержки, планирования миграции и коммуникации с клиентами при выпуске.
Ключевые особенности платформы¶
Что предоставляет v1.0.0 на всей платформе- Основная версия 1.0.0 для продакшена как для Numerology API, так и для Horoscope API.¶
- Значительное расширение области взаимодействия с конечными точками в продуктах numerology и horoscope.
- Завершение миграции вычислений horoscope на основе движка для основных потоков отчетов.
- Завершение выпуска Extended Numerology.
- Улучшенные структурированные шаблоны запросов POST, для обновленных маршрутов horoscope.
- Более широкая поддержка богатых структур данных ответов, корпоративных оберток и согласованности метаданных.
- Усиленная согласованность документации между публичными документами и примерами структур данных.
- Успешная многоязычная проверка работоспособности для расширенных конечных точек numerology.
- Улучшенное понимание маршрутов, обработка совместимости и руководство по миграции для клиентов, использующих продакшн.
- Расширенная поддержка персонализированных расчетов, где предоставляются векторы рождения и расширенные поля запросов.
- Улучшенное понимание операционной среды в отношении часовых поясов, системы зодиака, аянсамсы, систем домов и поведения узлов в потоках запросов horoscope.
Краткое описание выпуска### Расширение функциональности Numerology API¶
- Добавлены новые семейства конечных точек: 23
- Добавлена возможность объединения операций (
GET/POST): 41 - Выполнены запросы валидации/проверки: 205
- Документированная многоязычная проверка прошла успешно: 100.0%
- Расширена модель выпуска: добавляющаяся, без формального удаления в новой расширенной версии
Расширение функциональности Horoscope API¶
- Основные отчеты перенесены в внутренний движок
- Добавлены новые наборы отчетов по следующим категориям:
- планеты
- аспекты
- транзиты
- дом
- планета-дом
- Установлен стандартный namespace для отчетов под:
/api/v1/horoscope/reports/*- Несколько устаревших маршрутов сохранены как скрытые совместимые алиасы, в то время как публичная документация переходит на стандартные пути
Часть I — Numerology API v1.0.0¶
Основные моменты расширения функциональности Numerology API---¶
- Добавлена полная документация расширенной нумерологии в разделе расширенной документации.
- Добавлены и завершены Расширенные операции "Личное Недельное":
- Полная поддержка GET/POST запросов.
- Богатый формат ответа.
- Добавлены и завершены Расширения Универсального Цикла:
- Универсальный День
- Универсальная Неделя
- Универсальный Месяц
- Универсальный Год
- Стандартизирована документация расширенных конечных точек с полными таблицами параметров, опциями, примерами ответов и ссылками на связанные конечные точки.
- Подтверждена многоязыковая проверка работоспособности в
en,es,de,fr,ptс 100% успехом для расширенных операций. - Уточнен доступ: расширенные конечные точки доступны только на платформе напрямую и не поддерживаются через шлюз RapidAPI.
Расширение нумерологии — Добавлены новые конечные точки¶
Эта версия добавляет 23 семейства расширенных конечных точек и 41 операции (GET/POST объединены).
A) Конечные точки для циклов и времени| Endpoint | Методы | Путь |¶
|---|---|---| | Личный Неделя | GET, POST | /api/v1/personal-week | | Вселенный Год | GET, POST | /api/v1/universal-year | | Вселенный Месяц | GET, POST | /api/v1/universal-month | | Вселенная Неделя | GET, POST | /api/v1/universal-week | | Вселенный День | GET, POST | /api/v1/universal-day | | Ежемесячная Энергетическая Карта | GET, POST | /api/v1/monthly-energy-heatmap | | Календарь Опасных Дат | GET, POST | /api/v1/caution-dates-calendar |
B) Точки Контакта для Идентификации и Анализа Имен¶
| Endpoint | Методы | Путь |
|---|---|---|
| Нумерология Имени | GET, POST | /api/v1/username-numerology |
| Нумерология Названия Бизнеса | GET, POST | /api/v1/business-name-numerology |
| Сравнение Названий Брендов | POST | /api/v1/brand-name-compare |
| Влияние Изменения Имени | GET, POST | /api/v1/name-change-impact |
| Проверка Совместимости Дат | GET, POST | /api/v1/date-alignment-check |
C) Точки Контакта для Духовного и Теневого Анализа| Endpoint | Методы | Path |¶
|---|---|---| | Чтение частоты ауры | GET, POST | /api/v1/aura-frequency-reading | | Нумерология чакр | GET, POST | /api/v1/chakra-numerology | | Паттерны прошлых жизней | GET, POST | /api/v1/past-life-patterns | | Число "Работа с тенью" | GET, POST | /api/v1/shadow-work-number | | Чтение договора души | GET, POST | /api/v1/soul-contract-reading | | Индикатор связи с душой | POST | /api/v1/soul-connection-indicator | | Чтение духовных даров | GET, POST | /api/v1/spiritual-gifts-reading | | Чтение "Священного баланса" | GET, POST | /api/v1/sacred-balance-reading |
D) Endpoints для динамики отношений¶
| Endpoint | Методы | Path |
|---|---|---|
| "Состав отношений" | POST | /api/v1/relationship-composite |
| Чтение о исцелении в отношениях | POST | /api/v1/relationship-healing-reading |
| Нумерология "родитель-ребенок" | POST | /api/v1/parent-child-numerology |
Numerology API — Обновленные и исправленные endpoints¶
A) Новые основные расширенные поверхности¶
Следующие новые поверхности были полностью реализованы в этом цикле разработки с валидацией запросов и богатым выводом значений:
GET /api/v1/personal-weekPOST /api/v1/personal-weekGET /api/v1/universal-yearPOST /api/v1/universal-yearGET /api/v1/universal-monthPOST /api/v1/universal-monthGET /api/v1/universal-weekPOST /api/v1/universal-weekGET /api/v1/universal-dayPOST /api/v1/universal-day### Б) Применены исправления для повышения стабильности во время проверки "smoke" Пять операций, которые изначально генерировали422при использовании сгенерированных входных данных, были стабилизированы для обеспечения покрытия тестами, приближенного к производственному, и теперь возвращают успешные ответы при многоязычном тестировании:
POST /api/v1/brand-name-compareGET /api/v1/caution-dates-calendarPOST /api/v1/caution-dates-calendarGET /api/v1/monthly-energy-heatmapPOST /api/v1/monthly-energy-heatmap
C) Практические правила проверки усилены¶
The following constraints were tightened and clarified during validation and documentation work:
- Сравнение брендов требует как минимум двух записей в
names[].- Входные данные для календаря и тепловой карты используют форматYYYY-MM.- Предупреждающие датыtop_nостаются в пределах диапазона1..31.- Client payloads benefit from prevalidation before submission to reduce avoidable422or format-level errors.
D) Исправление несоответствий в документации и OpenAPI¶
Все расширенные документы нормализованы для обеспечения соответствия при интеграции: - Полные таблицы параметров для каждого метода- детали параметров- шаблоны, диапазоны, значения по умолчанию и поля вложенных объектов- Примеры разделов с богатым форматом, основанные на данных, полученных в результате имитации (smoke testing)
---- стандартизированные заметки об доступе и доступности
--- КОНЕЦ МАРКДАУН ---- кнопки призыва к действию (CTA) на панели управления, разделы с заметками и соответствующие подвальные части конечных точек
---¶
Numerology API — Обзор проверки качества¶
Артефакты валидации для расширенного набора нумерологии:
- Файлы с итогом: 23
- Операции, протестированные: 41
- Общее количество запросов: 205
- Общая процентная доля успеха: 100.0%
- Успешность по языкам:
en— 100%es— 100%de— 100%fr— 100%pt— 100%
Этот релиз завершает цикл запуска расширенной нумерологии с уверенностью в валидации, применимой к документации, для всех поддерживаемых языков.
Numerology API — Отмененные функции¶
Для релиза Numerology Extended v1.0.0, ни один из конечных точек в расширенном наборе не объявлен официально как устаревший.
| Конечная точка | Статус в v1.0.0 | Замена | Примечания |
|---|---|---|---|
| Нет | Не применимо | Не применимо | Расширенный набор является добавленным в этом релизе. |
Numerology API — Изменения, требующие обновления¶
В этом релизе не вносятся изменения, затрагивающие конечные точки расширенной нумерологии.
Тем не менее, интеграторам следует учитывать следующие ожидания на уровне развертывания:- Расширенные конечные точки не доступны через RapidAPI в настоящее время. - Клиенты, интегрирующие расширенные конечные точки, должны обращаться к основному хосту платформы напрямую. - Некоторые новые конечные точки доступны только через POST и не следует предполагать их совместимость с GET.
Numerology API — Заметки о миграции¶
1) Миграция канала доступа¶
Расширенные конечные точки доступны через прямой доступ к платформе:
- Базовый URL:
https://api.numerologyapi.com - Аутентификация:
X-API-Key: YOUR_API_KEY- или
Authorization: Bearer YOUR_API_KEY
Расширенные конечные точки в настоящее время не поддерживаются через gateway RapidAPI.
2) Руководство по использованию GET vs POST¶
Большинство расширенных конечных точек поддерживают как GET, так и POST с эквивалентными результатами.
Используйте:
GETдля простых запросовPOSTдля более строгой структуры данных, вложенных объектов и обеспечения соответствия SDK/backend
Конечные точки, доступные только по POST, включают:
/api/v1/brand-name-compare/api/v1/relationship-composite/api/v1/relationship-healing-reading/api/v1/parent-child-numerology/api/v1/soul-connection-indicator
3) Правила валидации входных данных на стороне клиента¶
Рекомендуемая предварительная валидация на стороне клиента:- dob и target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: валидная строка IANA для часового пояса - top_n: целое число в диапазоне от 1..31 - names[]: минимум 2 записи для сравнения брендов - context для выравнивания даты: максимальная длина 80, принимаются нормализованные псевдонимы
4) Вложенные шаблоны тела запроса¶
Для конечных точек отношений и совместимости используйте явные вложенные объекты, например:
person_aperson_bparentchild
Каждый объект должен содержать обязательные поля, например:
full_namedob
5) Обработка языка и метаданных¶
Расширенные конечные точки нумерологии поддерживают многоязычное отображение ответов через lang.
Поддерживаемые языки для проверки:
enesdefrpt
Ответы могут содержать обертки метаданных в стиле enterprise:
_enterprise_api_metadata_
Клиенты должны сохранять и анализировать эти поля, когда это полезно для анализа платформы, информации о плане или метаданных конечной точки.
6) Новое покрытие циклов¶
Клиенты, которые ранее использовали только потоки "день/месяц/год", теперь могут расширить логику расписания для покрытия:- Еженедельные личные циклы через /api/v1/personal-week - Общие временные поверхности через: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year
7) Источник истины для документации¶
Полные страницы интеграции на уровне конечных точек для этой версии поддерживаются в разделе расширенной документации, включая главную страницу и страницы для каждой конечной точки.
Numerology API — Рекомендации по обновлению¶
- Перенесите сложные вызовы к прямому доступу к API через
https://api.numerologyapi.com. - Убедитесь, что валидаторы запросов обеспечивают формат даты, месяца и часового пояса.
- Добавьте обработку резервных значений для многоязычных
lang, где это необходимо. - Обновите клиентов для последовательной обработки
_enterpriseи_api_metadata_. - Для вложенных конечных точек, выровняйте модели запросов SDK с требуемыми ключами объектов.
- Проверьте соответствие требованиям перед переходом в производство.
- Убедитесь, что все сложные вызовы маршрутизируются за пределами предположений клиентов на основе RapidAPI.
Numerology API — Краткое описание изменений¶
Numerology API v1.0.0 представляет собой полную расширенную поверхность нумерологии с расширением еженедельных и универсальных циклов, продвинутым анализом отношений и духовности, более богатыми контрактами запросов/ответов, а также полностью синхронизированной документацией и соответствием требованиям к тестированию.# Часть II — Расширение Horoskop v1.0.0
Основные особенности расширения Horoskop¶
- Завершена миграция основных потоков создания отчетов о гороскопах на движок Swiss Ephemeris.
- Стандартизированы обновленные конечные точки для запросов, ориентированные на первый запрос POST.
- Добавлено широкое покрытие разделами для ежедневных, еженедельных, ежемесячных и годовых периодов.
- Переструктурированы конечные точки для отчетов о планетах по периоду и уровню детализации/обзора.
- Переименована конечная точка словаря планет, чтобы отражать ее информационную функциональность, а не функциональность создания отчетов.
- Расширено соответствие запросов на натальную карту и усилена валидация формы ответа.
- Нормализованы ответы обновленных конечных точек для содержимого движка плюс обертки метаданных предприятия.
- Обновлены примеры в публичной документации с обеспечением соответствия JSON.
Расширение Horoskop — Добавленные новые конечные точки¶
A) Новые вспомогательные и стандартные поверхности¶
GET /api/v1/horoscope/timezones
B) Комплект отчетов о планетах (Поверхность, ориентированная на период)¶
Разделы (не для общего использования):
POST /api/v1/horoscope/reports/planetary/dailyPOST /api/v1/horoscope/reports/planetary/weeklyPOST /api/v1/horoscope/reports/planetary/monthlyPOST /api/v1/horoscope/reports/planetary/yearly
Обзор (только для общего использования):
POST /api/v1/horoscope/reports/planetary/daily/overviewPOST /api/v1/horoscope/reports/planetary/weekly/overviewPOST /api/v1/horoscope/reports/planetary/monthly/overviewPOST /api/v1/horoscope/reports/planetary/yearly/overview
Расширенное покрытие секциями планет по периодам включает в себя разделы, поддерживаемые движком, такие как:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples
C) Комплекс отчетов об аспектах (Периодическая поверхность)¶
Разделы (необщие):
POST /api/v1/horoscope/reports/aspects/dailyPOST /api/v1/horoscope/reports/aspects/weeklyPOST /api/v1/horoscope/reports/aspects/monthlyPOST /api/v1/horoscope/reports/aspects/yearly
Обзор (только общий):
POST /api/v1/horoscope/reports/aspects/daily/overviewPOST /api/v1/horoscope/reports/aspects/weekly/overviewPOST /api/v1/horoscope/reports/aspects/monthly/overviewPOST /api/v1/horoscope/reports/aspects/yearly/overview
aspects/* поддерживает:
- общедоступный режим
- персонализированный режим
- необязательное переопределение
aspect - ту же модель раздела, используемую в обновленных маршрутах прогнозирования
D) Комплекс отчетов о транзитах (Периодическая поверхность)¶
Разделы (необщие):
POST /api/v1/horoscope/reports/transits/dailyPOST /api/v1/horoscope/reports/transits/weeklyPOST /api/v1/horoscope/reports/transits/monthlyPOST /api/v1/horoscope/reports/transits/yearly
Обзор (только общий):
POST /api/v1/horoscope/reports/transits/daily/overviewPOST /api/v1/horoscope/reports/transits/weekly/overviewPOST /api/v1/horoscope/reports/transits/monthly/overviewPOST /api/v1/horoscope/reports/transits/yearly/overview
transits/* поддерживает:
- общедоступный режим
- персонализированный режим
- необязательное переопределение
transit - ту же модель раздела, используемую в обновленных маршрутах прогнозирования
E) Комплекс отчетов о домах (Только для персонализации, Периодическая поверхность)¶
Отчеты о домах (необщие разделы):
POST /api/v1/horoscope/reports/house/dailyPOST /api/v1/horoscope/reports/house/weeklyPOST /api/v1/horoscope/reports/house/monthlyPOST /api/v1/horoscope/reports/house/yearly
Обзоры домов (только общий):
POST /api/v1/horoscope/reports/house/daily/overviewPOST /api/v1/horoscope/reports/house/weekly/overviewPOST /api/v1/horoscope/reports/house/monthly/overviewPOST /api/v1/horoscope/reports/house/yearly/overview
Отчеты о планетах и домах (необщие разделы):
POST /api/v1/horoscope/reports/planet/house/dailyPOST /api/v1/horoscope/reports/planet/house/weeklyPOST /api/v1/horoscope/reports/planet/house/monthly-
POST /api/v1/horoscope/reports/planet/house/yearlyPlanet-house overviews (general-only): -
POST /api/v1/horoscope/reports/planet/house/daily/overview POST /api/v1/horoscope/reports/planet/house/weekly/overviewPOST /api/v1/horoscope/reports/planet/house/monthly/overviewPOST /api/v1/horoscope/reports/planet/house/yearly/overview
Both route families are intended for personalization only and are backed by engine endpoints such as:
/house-horoscope/planet-house-horoscope
F) Canonicalization of Report Namespace¶
Canonical live-report paths now use the /api/v1/horoscope/reports/* namespace across upgraded engine-backed horoscope surfaces.
Legacy non-report paths remain registered as hidden compatibility aliases.
G) Newly Added Horoscope Section Route Families Across Periods¶
Communication¶
POST /api/v1/horoscope/reports/communication/daily/todayPOST /api/v1/horoscope/reports/communication/daily/tomorrowPOST /api/v1/horoscope/reports/communication/daily/yesterdayPOST /api/v1/horoscope/reports/communication/weeklyPOST /api/v1/horoscope/reports/communication/monthlyPOST /api/v1/horoscope/reports/communication/yearly
Friendship¶
POST /api/v1/horoscope/reports/friendship/daily/todayPOST /api/v1/horoscope/reports/friendship/daily/tomorrowPOST /api/v1/horoscope/reports/friendship/daily/yesterdayPOST /api/v1/horoscope/reports/friendship/weeklyPOST /api/v1/horoscope/reports/friendship/monthlyPOST /api/v1/horoscope/reports/friendship/yearly
Lifestyle¶
POST /api/v1/horoscope/reports/lifestyle/daily/todayPOST /api/v1/horoscope/reports/lifestyle/daily/tomorrowPOST /api/v1/horoscope/reports/lifestyle/daily/yesterdayPOST /api/v1/horoscope/reports/lifestyle/weeklyPOST /api/v1/horoscope/reports/lifestyle/monthlyPOST /api/v1/horoscope/reports/lifestyle/yearly
Love Split Surfaces (Singles/Couples)¶
POST /api/v1/horoscope/reports/love_singles/daily/todayPOST /api/v1/horoscope/reports/love_singles/daily/tomorrowPOST /api/v1/horoscope/reports/love_singles/daily/yesterdayPOST /api/v1/horoscope/reports/love_singles/weeklyPOST /api/v1/horoscope/reports/love_singles/monthlyPOST /api/v1/horoscope/reports/love_couples/daily/todayPOST /api/v1/horoscope/reports/love_couples/daily/tomorrowPOST /api/v1/horoscope/reports/love_couples/daily/yesterdayPOST /api/v1/horoscope/reports/love_couples/weeklyPOST /api/v1/horoscope/reports/love_couples/monthly
Yearly Section Additions¶
POST /api/v1/horoscope/reports/health/yearlyPOST /api/v1/horoscope/reports/money/yearly
H) Renamed Informational Planets Surface¶
GET /api/v1/horoscope/planets-infoPOST /api/v1/horoscope/planets-info
This replaces the previous /horoscope/planets naming for the informational glossary-style behavior.## Расширение прогнозов — Обновленные и Исправленные Эндпоинты
A) Миграция движка и обновления поведения¶
Следующие существующие семейства маршрутов были обновлены до поведения, основанного на внутреннем движке:
Основные маршруты для отчетов¶
POST /api/v1/horoscope/reports/todayPOST /api/v1/horoscope/reports/yesterdayPOST /api/v1/horoscope/reports/tomorrowPOST /api/v1/horoscope/reports/weeklyPOST /api/v1/horoscope/reports/monthlyPOST /api/v1/horoscope/reports/yearly
Существующие маршруты категорий, обновленные из устаревшей функциональности horoscope.com¶
- карьера
- здоровье
- любовь
- деньги
Существующие и устаревшие семейства переструктурированы и обновлены¶
- Устаревшие маршруты для любви разделены на
love_singlesиlove_couples - Объединенная функциональность
yearly/career_moneyзаменена специализированными ежегодными маршрутами для карьеры и денег. - Планетарные устаревшие маршруты отчетов и обзоров перемещены в периодизированные маршруты.
B) Уточнение эндпоинта описания знака зодиака¶
Следующие поверхности остаются эндпоинтами, предоставляющими описание знака, а не актуальными данными:
/api/v1/horoscope/sign/personality/api/v1/horoscope/sign/communication/api/v1/horoscope/sign/friendship/api/v1/horoscope/sign/love/api/v1/horoscope/sign/lifestyle/api/v1/horoscope/sign/health/api/v1/horoscope/sign/career/api/v1/horoscope/sign/money/api/v1/horoscope/sign/parent_child/api/v1/horoscope/sign/spirituality/api/v1/horoscope/sign/shadow
C) Обновление соответствия прогноза по дате рождения¶
POST /api/v1/horoscope/reports/birthday теперь предоставляет ключи запросов, основанные на внутреннем движке, при этом сохраняются совместимые ключи.
Обновленный каноничный эндпоинт:
POST /api/v1/horoscope/reports/birthday
Сохранены скрытые алиасы для совместимости:- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday
Ключи запросов, специфичные для движка:
signtarget_datebirthsectionszodiac_systemayanamsahouse_systemnode_typetenant_id
Совместимые ключи сохранены:
dobtimezoneyearbirth_timebirth_latitudebirth_longitudebirth_timezone
D) Обновление соответствия натальной карты¶
Эти поверхности существовали до версии 1.0.0 и теперь обновлены для полной совместимости с движком:
POST /api/v1/birth-chartPOST /api/v1/birth-chart/svg
Улучшения включают:
- Полную поддержку опции запроса "шлюз" к движку
- Совместимость поля конфигурации "wheel"
- Более строгую валидацию структуры ответа
E) Нормализация контракта ответа¶
Обновленные конечные точки, поддерживаемые движком "Horoscope", возвращают:
- Сырые данные ответа движка
_enterprise_api_metadata_
F) Обработка часовых поясов и относительных дат¶
Ежедневные конечные точки, использующие today, yesterday и tomorrow, теперь применяют разрешение целевой даты с учетом часового пояса через вход IANA.
G) Уточнение поддержки персонализации¶
При поддержке, отчеты, основанные на персональных данных, активируются путем предоставления полей "birth-vector", таких как:
birth_timebirth_latitudebirth_longitudebirth_timezone
Если они отсутствуют, маршруты остаются пригодными для использования в обобщенном режиме на основе знаков.## Расширенные прогнозы — устаревшие, скрытые и удалённые конечные точки| Endpoint | Статус в v1.0.0 | Замена | Примечания | |---|---|---|---| | Маршрут для старого агрегированного отчета о планетах | Удален | Маршруты периодов с длиной периода менее, чем /reports/planetary/, плюс соответствующие маршруты /overview | Точка входа удалена после завершения приведения к периодам. | | POST /api/v1/horoscope/planetary/overview | Устаревший (скрыт в OpenAPI) | POST /api/v1/horoscope/reports/planetary/daily/overview, POST /api/v1/horoscope/reports/planetary/weekly/overview, POST /api/v1/horoscope/reports/planetary/monthly/overview, POST /api/v1/horoscope/reports/planetary/yearly/overview | Заменен на маршруты обзора для конкретных периодов. | | POST /api/v1/horoscope/planetary/daily/sections | Внутренний псевдоним | POST /api/v1/horoscope/reports/planetary/daily | Псевдоним для обеспечения совместимости. | | POST /api/v1/horoscope/love_single/monthly | Устаревший псевдоним (скрыт) | POST /api/v1/horoscope/reports/love_singles/monthly | Сохранен для совместимости. | | POST /api/v1/horoscope/weekly/retail | Устаревший (скрыт в OpenAPI/docs) | Нет | Еженедельный отчет о розничных продажах удален из публичной документации. | | Маршрут для гибкого агрегированного отчета о гороскопах | Удален | Маршруты отчетов, специфичные для раздела, и маршруты обзора периодов | Точка входа удалена после полного разделения конечных точек. | | POST /api/v1/horoscope/yearly/career_money | Удален | POST /api/v1/horoscope/reports/career/yearly и POST /api/v1/horoscope/reports/money/yearly | Разделение конечной точки преобразовано в отдельные маршруты. | | POST /api/v1/horoscope/love/{today,tomorrow,yesterday} | Удалена активная регистрация | POST /api/v1/horoscope/reports/love_singles/daily/{today,tomorrow,yesterday} или POST /api/v1/horoscope/reports/love_couples/daily/{today,tomorrow,yesterday} | "Ежедневная любовь" теперь разделена по контексту отношений. || GET /api/v1/horoscope/planets и POST /api/v1/horoscope/planets | Переименовано/удалено | GET /api/v1/horoscope/planets-info и POST /api/v1/horoscope/planets-info | Изменение имени информационного эндпоинта для повышения ясности. |
Расширение Horoskop — Изменения, требующие внимания¶
- Переименование маршрута:
/api/v1/horoscope/planets→/api/v1/horoscope/planets-info - Стандартное пространство имен для отчетов о гороскопе с поддержкой движка теперь
/api/v1/horoscope/reports/* - Объединенные ежедневные маршруты для любви заменены на явные маршруты для одиноких и пар
- Объединенный годовой
career_moneyмаршрут удален в пользу специализированных годовых маршрутов - Общие отчеты и обзоры планет, а также эндпоинты заменены на маршруты с структурой по периодам
- Улучшенные маршруты с поддержкой движка стандартизированы вокруг запросов POST
Расширение Horoskop — Замечания о совместимости¶
- Старые
/api/v1/horoscope/report/*маршруты остаются доступными как скрытые, обратно-совместимые псевдонимы - Публикуемая документация и OpenAPI теперь содержат только стандартное пространство имен
/api/v1/horoscope/reports/* - Новые интеграции должны сразу использовать пути
/reports/*
Расширение Horoskop — Замечания о миграции¶
1) Карта миграции маршрутов эндпоинтов- GET/POST /api/v1/horoscope/planets → GET/POST /api/v1/horoscope/planets-info¶
POST /api/v1/horoscope/report/{surface}→POST /api/v1/horoscope/reports/{surface}POST /api/v1/horoscope/{surface}→POST /api/v1/horoscope/reports/{surface}POST /api/v1/horoscope/planetary/overview→POST /api/v1/horoscope/reports/planetary/{period}/overview- Устаревший маршрут агрегации планет: использовать
POST /api/v1/horoscope/reports/planetary/{period}или эквивалентный маршрут обзора. - Устаревший гибкий маршрут агрегации гороскопа: использовать маршруты, специфичные для раздела, или маршруты обзора.
POST /api/v1/horoscope/yearly/career_money: разделить на ежегодные маршруты по карьере и ежегодные маршруты по финансам.- Устаревшие ежедневные маршруты любви: разделить на
love_singlesилиlove_couples
2) Миграция Payload запроса¶
Для обновленных маршрутов, поддерживаемых движком, используйте структурированные тела POST с полями, такими как:
dobtimezone- Селекторы периодов:
day,target_dateилиyear. - Необязательные опции движка:
zodiac_systemayanamsahouse_systemnode_typetenant_id- Необязательные поля персонализации:
birth_timebirth_latitudebirth_longitudebirth_timezone
3) Правила миграции маршрутов планет¶
- Используйте
sectionsтолько для не-обзорных планетарных периодов. generalдоступно через специализированные маршруты/overview.
4) Миграция парсера ответа¶
Клиенты должны анализировать:
- Поля payload отчета непосредственно из тела ответа.
_enterprise_api_metadata_
5) Замечание о поведении переводаThe horoscope engine itself does not generate multilingual content directly, so report based endpoints currently support but en only.¶
Non-report endpoints continue to support full multilingual translation through gateway helper layers using lang, such as:
enesdefrpt
Расширение Horoskop – Документация и Согласованность с Тестированием Завершены¶
- Публикуемая документация обновлена для новых маршрутов прогнозирования (horoscope).- Исторические планетарные документы заменены на документы, относящиеся к конкретному периоду времени
---- Разделение документации о карьере и финансах, при котором удалены объединенные маршруты
---- Пример JSON, синхронизированный с ответами конечных точек, для обновленных документаций
---¶
Расширение прогнозов – Список рекомендованных обновлений для клиентов¶
- Обновить все переименованные и устаревшие пути, используя карту миграции
--- КОНЕЦ МАРКДАУН ---- Переключите любые устаревшие потребители GET запросов на обновленные маршруты отчетов на запросы тела POST
--- КОНЕЦ МАРКАДОՒ- Добавить часовой пояс ко всем ежедневным потокам, чтобы избежать смещения дат- Добавьте поля персонализации, где требуется отображение контента, адаптированного для конкретного пользователя
--- КОНЕЦ МАРКДАУН ---- Обновить парсеры ответов для сохранения _enterprise и _api_metadata_- Повторно выполнить интеграционные тесты по всем конечным точкам, используемым в производственной среде для прогнозирования (horoscope).¶
Обзор изменений — Рекомендации по выпуску¶
Numerology API v1.0.0 завершает масштабное внедрение, расширяет покрытие отчетов по разделам и периодам, вводит более чистую структуру основных маршрутов и создает более четкую производственную среду для будущих версий движка прогнозирования.
Часть III — Руководство по интеграции между API¶
Единые рекомендации по интеграции для клиентов, использующих Numerology API¶
Клиенты, использующие как конечные точки Numerology, так и Horoscope, должны изучить следующее вместе:
Аутентификация и доступ¶
- Расширенные конечные точки Numerology доступны только напрямую (без поддержки RapidAPI gateway)
- Конечные точки horoscope, поддерживаемые движком, также доступны только напрямую и продолжают работать в рамках своего стандартного API namespace с обновленными шаблонами gateway
- Сохранять поддержку для оберток метаданных корпоративного уровня
Моделирование запросов¶
- Предпочтительно использовать явные структурированные тела POST для всех новых или расширенных конечных точек
- Проверять форматы дат, селекторы периодов, строки часовых поясов и вложенные объекты на стороне клиента
- При наличии, предоставлять векторы персонализации для более богатых результатов### Временная зона и семантика даты
- Эндпоинты Numerology зависят от правильного формата даты и месяца
- Ежедневные маршруты Horoscope зависят от корректной обработки временных зон для разрешения относительных дат
- Рекомендуется использовать строковые представления IANA, если это поддерживается
Обработка языка¶
- Расширенные эндпоинты Numerology имеют многоязычное рендеринг, прошедшее проверку
- Маршруты Horoscope, поддерживаемые движком, продолжают поддерживать только
en
Рекомендации по развертыванию в продакшн¶
- Обновите SDK и валидаторы запросов в первую очередь
- Обновите интеграционные тесты во второй фазе
- Затем продвигайте изменения маршрутов/путей для клиентов, использующих production
- Отслеживайте любые скрытые алиасы совместимости, которые все еще используются внутренне, чтобы можно было безопасно их убрать позже
Часть IV — Итоговый обзор выпуска¶
Что означает v1.0.0¶
v1.0.0 – это точка, когда обе поверхности становятся значительно более полными и пригодными для production:- Numerology API теперь предоставляет гораздо более полный и расширенный каталог, охватывающий такие темы, как время, идентичность, духовное понимание, работа со "тенью", отношения, совместимость и предсказательные календари. - Отчеты о гороскопах теперь основаны на значительно более надежной платформе с каноническими пространствами имен отчетов, более широким охватом разделов, более четкими схемами миграции и лучшей совместимостью между семействами отчетов. - Документация, примеры, поведение валидации и рекомендации по совместимости значительно более зрелые, чем в состоянии до v1.0.0.
Эта версия — не просто обновление версии. Это структурное обновление, которое улучшает:
- полноту платформы
- ясность маршрутов
- готовность к миграции клиентов
- уверенность в документации
- согласованность интеграции для предприятий
Рекомендации по эксплуатации¶
Для всех активных интеграторов рекомендуемый путь — это:
- немедленно использовать канонические маршруты
- обновить модели запросов для POST-первых данных, где это применимо
- сохранить парсинг метаданных
- выполнять валидацию форматов времени/даты на стороне клиента
- перенести потребителей расширенных функций Numerology к прямому доступу к платформе
- повторно выполнить полный набор тестов интеграции перед развертыванием в производство