Rozszerzenie Numerologii + Rozszerzenie Horoskopu v1.0.0 - Ujednolicony Log Zmian¶
Data wydania: 2026-04-12 Wersja: v1.0.0 Zakres: Pełne wydanie platformy obejmujące Numerology API, Rozszerzenie Horoskopu: w tym rozszerzone wdrażanie endpointów, migrację raportów horoskopowych opartych na silniku, normalizację żądań/odpowiedzi, spójność dokumentacji, walidację wielojęzykową oraz wskazówki dotyczące integracji z produkcją.
Przegląd¶
v1.0.0 to duże wydanie produkcyjne w ramach platformy Dakidarts API. Łączy dwa duże obszary pracy w jednym skoordynowanym wdrażaniu:
- Rozszerzenie Numerologii
- Dodaje pełną, rozbudowaną powierzchnię numerologii.
- Rozszerza zakres czasowy i cykle, obejmując indywidualny tydzień, uniwersalny dzień/tydzień/miesiąc/rok.
- Wprowadza głębsze endpointy dotyczące duchowości, relacji, tożsamości i analizy cieni.
- Zapewnia spójność dokumentacji, przykłady odpowiedzi oraz walidację wielojęzykową.
- Rozszerzenie Horoskopu
- Ukończa główną migrację generowania raportów horoskopowych do wbudowanego silnika Swiss Ephemeris.
- Standaryzuje trasy raportów obsługiwanych przez silnik pod
/api/v1/horoscope/reports/*. - Dodaje szeroki zakres pokrycia dla okresów dziennych, tygodniowych, miesięcznych i rocznych.
- Wprowadza zestawy raportów planetarnych, aspektów, transitu i domów w oparciu o okresy.
- Poprawia spójność payloadu, zachowanie personalizacji, aliasy kompatybilności oraz spójność dokumentacji.
Ten log zmian ma służyć jako jedyne źródło informacji dla integratorów, przeglądu wewnętrznego, wsparcia, planowania migracji i komunikacji z klientami w zakresie wydania.
Kluczowe Funkcje Platformy¶
Co wersja 1.0.0 oferuje na całej platformie- Główna wersja produkcyjna v1.0.0 dla zarówno Numerology API, jak i Horoscope API.¶
- Szeroka rozbudowa powierzchni endpointów w produktach związanych z numerologią i horoskopem.
- Ukończenie migracji obliczeń horoskopowych opartej na silniku dla głównych przepływów raportów.
- Ukończenie ścieżki wydania Rozszerzonej Numerologii.
- Poprawa strukturalnych wzorców żądań typu POST dla zaktualizowanych tras horoskopowych.
- Szersze wsparcie dla bogatych payloadów odpowiedzi, opakowań korporacyjnych i spójności metadanych.
- Silniejsza spójność dokumentacji pomiędzy dokumentacją publiczną a przykładowymi payloadami.
- Sukcesne wielojęzyczne testy walidacyjne dla rozszerzonych endpointów numerologii.
- Poprawa jasności tras, obsługi kompatybilności i wskazówek dotyczących migracji dla klientów produkcyjnych.
- Rozszerzone wsparcie dla spersonalizowanych obliczeń, gdzie podawane są wektory urodzeniowe oraz zaawansowane pola żądania.
- Poprawa jasności operacyjnej w zakresie stref czasowych, systemu astrologicznego, ayanmsy, systemów domów i zachowania węzłów w przepływach żądań horoskopowych.
Podsumowanie Składu Wydania### Rozszerzenie Numerologii¶
- Dodano nowe rodziny endpointów: 23
- Dodano połączone operacje (
GET/POST): 41 - Wykonano żądania walidacyjne/testowe: 205
- Udokumentowano wielojęzyczne pomyślne testy: 100,0%
- Rozszerzony model wydawania: dodatkowy, bez formalnych deprecacji w nowej rozszerzonej wersji
Rozszerzenie Horoskopu¶
- Główne raporty przeniesiono do wewnętrznego silnika
- Dodano nowe zestawy raportów obejmujące:
- planetarne
- aspekty
- przejścia
- domy
- planeta-dom
- Ustanowiono standardową przestrzeń nazw raportów pod:
/api/v1/horoscope/reports/*- Wiele starych tras zachowano jako ukryte aliasy kompatybilności, podczas gdy publiczna dokumentacja rozwija się z wykorzystaniem standardowych ścieżek
Część I — Numerology API v1.0.0¶
Kluczowe elementy rozszerzenia Numerologii- Dodano pełną dokumentację powierzchni Rozszerzonej Numerologii w sekcji dokumentacji rozszerzonej.¶
- Dodano i ukończono Tydzień Osobowy, z pełną zgodnością GET/POST oraz obsługą bogatych payloadów odpowiedzi.
- Dodano i ukończono Rozszerzenia Cyklu Uniwersalnego:
- Dzień Uniwersalny
- Tydzień Uniwersalny
- Miesiąc Uniwersalny
- Rok Uniwersalny
- Standaryzowano dokumentację rozszerzonych endpointów z kompletnymi tabelami parametrów, opcjami, przykładami odpowiedzi oraz powiązanymi linkami do endpointów.
- Potwierdzono pokrycie testowe w wielu językach dla
en,es,de,fr,ptprzy 100% sukcesie dla operacji rozszerzonych. - Wyjaśniono model dostępu: endpointy rozszerzone są dostępne tylko w ramach platformy, a obecnie nie są obsługiwane za pośrednictwem bramy RapidAPI.
Rozszerzenie Numerologii — Dodane Endpointy¶
Ta wersja dodaje 23 rodziny rozszerzonych endpointów oraz 41 operacji (GET/POST).
A) Endpointy Cykli i Harmonogramu| Endpoint | Metody | Ścieżka |¶
|---|---|---| | Tygodnia Osoby | GET, POST | /api/v1/personal-week | | Rok | GET, POST | /api/v1/universal-year | | Miesiąc | GET, POST | /api/v1/universal-month | | Tydzień | GET, POST | /api/v1/universal-week | | Dzień | GET, POST | /api/v1/universal-day | | Mapa Energetyczna Miesiąca | GET, POST | /api/v1/monthly-energy-heatmap | | Kalendarz Ostrzeżeń | GET, POST | /api/v1/caution-dates-calendar |
B) Punkty Konfiguracyjne Identyfikacji i Nazwy¶
| Endpoint | Metody | Ścieżka |
|---|---|---|
| Numerologia Imienia Użytkownika | GET, POST | /api/v1/username-numerology |
| Numerologia Nazwy Firmy | GET, POST | /api/v1/business-name-numerology |
| Porównanie Nazw Marki | POST | /api/v1/brand-name-compare |
| Wpływ Zmiany Nazwy | GET, POST | /api/v1/name-change-impact |
| Sprawdzenie Dopasowania Dat | GET, POST | /api/v1/date-alignment-check |
C) Punkty Konfiguracyjne Analizy Duchowej i Cienia| Endpoint | Metody | Ścieżka |¶
|---|---|---| | Odczyt Częstotliwości Aury | GET, POST | /api/v1/aura-frequency-reading | | Numerologia Chakr | GET, POST | /api/v1/chakra-numerology | | Wzorce Życia | GET, POST | /api/v1/past-life-patterns | | Liczba Pracy z Cieniem | GET, POST | /api/v1/shadow-work-number | | Odczyt Kontraktu Duszy | GET, POST | /api/v1/soul-contract-reading | | Wskaźnik Połączenia Duszy | POST | /api/v1/soul-connection-indicator | | Odczyt Dary Duchowych | GET, POST | /api/v1/spiritual-gifts-reading | | Odczyt Świętej Równowagi | GET, POST | /api/v1/sacred-balance-reading |
D) Punkty Konfiguracyjne dla Dynamiki Relacji¶
| Endpoint | Metody | Ścieżka |
|---|---|---|
| Kompozycja Relacji | POST | /api/v1/relationship-composite |
| Odczyt Leczenia w Relacjach | POST | /api/v1/relationship-healing-reading |
| Numerologia Rodzic-Dziecko | POST | /api/v1/parent-child-numerology |
API Numerologii — Zaktualizowane i Naprawione Punkty Konfiguracyjne¶
A) Nowo Wprowadzone Podstawowe Interfejsy¶
Następujące interfejsy zostały w tym cyklu wydawnym zrealizowane od początku do końca, wraz z walidacją żądań i bogatymi wynikami:
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### B) Naprawione Problemy Stabilności Podczas Walidacji Początkowej Pięć operacji, które początkowo generowały422przy użyciu symulowanych danych wejściowych, zostały ustabilizowane w celu zapewnienia pokrycia testowego zbliżonego do warunków produkcyjnych i teraz zwracają udane odpowiedzi przy wielojęzycznych symulacjach: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) Wzmocnione praktyczne zasady walidacji¶
Następujące ograniczenia zostały doprecyzowane i sprecyzowane podczas procesu weryfikacji i dokumentowania: - Porównywanie marek wymaga co najmniej dwóch wpisów w names[].- Wejścia kalendarza i wykresu termicznego używają formatu YYYY-MM.- Ostrzeżenia dotyczące dat top_n pozostają ograniczone do zakresu 1..31.- Dane klienta korzystają z wstępnej walidacji przed wysłaniem, aby zmniejszyć niepotrzebne 422 lub błędy na poziomie formatowania.
D) Naprawa nieśpójności dokumentacji i OpenAPI¶
Wszystkie rozszerzone dokumenty zostały znormalizowane, aby zapewnić spójność integracji: - Pełne tabele parametrów dla każdego sposobu- szczegóły opcji parametru
--- KONIEC MARKO- wzorce, zakresy, domyślne wartości oraz pola obiektów wagnieźionych
---- Przykładowe sekcje odpowiedzi, oparte na danych generowanych przez testy (smoke tests)
---- standaryzowane noty dotyczące dostępu i dostępności
---- przyciski CTA na panelu, sekcje z notatkami oraz powiązane stopki endpointów
---¶
Numerologia API – Raport z Weryfikacji Jakości¶
Artefakty weryfikacyjne dla rozszerzonego zestawu numerologii:
- Pliki podsumowujące: 23
- Operacje przetestowane: 41
- Całkowita liczba żądań wykonanych: 205
- Ogólny współczynnik sukcesu: 100.0%
- Sukces w językach:
en— 100%es— 100%de— 100%fr— 100%pt— 100%
Ta wersja kończy cykl wdrożeniowy rozszerzonego zestawu numerologii, zapewniając pewność weryfikacji dla wszystkich udokumentowanych języków.
Numerologia API – Deprecje¶
Dla wersji Numerologia Rozszerzona v1.0.0, żaden punkt końcowy na rozszerzonej powierzchni nie jest formalnie deprecjonowany.
| Punkt końcowy | Status w v1.0.0 | Alternatywa | Uwagi |
|---|---|---|---|
| Brak | Nie dotyczy | Nie dotyczy | Rozszerzony zestaw jest dodawany w tej wersji. |
Numerologia API – Zmiany powodujące przerwanie działania¶
W tej wersji nie wprowadzono zmian powodujących usunięcie ścieżek dla rozszerzonej powierzchni numerologii.
Jednak, integratorzy powinni zwrócić uwagę na następujące oczekiwania dotyczące wdrożenia:- Rozszerzone punkty końcowe nie są dostępne za pośrednictwem RapidAPI w tym momencie. - Klienty integrujące rozszerzone punkty końcowe powinny kierować się bezpośrednio do hosta platformy. - Niektóre nowe punkty końcowe są dostępne tylko dla POST i nie należy zakładać, że mają one równoważność z GET.
Numerology API — Uwagi dotyczące migracji¶
1) Migracja kanału dostępu¶
Rozszerzone punkty końcowe są dostępne za pośrednictwem bezpośredniego dostępu do platformy:
- Podstawowy URL:
https://api.numerologyapi.com - Autentykacja:
X-API-Key: YOUR_API_KEY- lub
Authorization: Bearer YOUR_API_KEY
Rozszerzone punkty końcowe są obecnie nie obsługiwane za pośrednictwem bramy RapidAPI.
2) Wytyczne dotyczące użycia GET vs POST¶
Większość rozszerzonych punktów końcowych obsługuje zarówno GET, jak i POST z równoważnym zamiarem wyjściowym.
Użyj:
GETdla prostych wywołań opartych na zapytaniachPOSTdla bardziej złożonej struktury payload, wbudowanych obiektów i spójności z SDK/backendem
Punkty końcowe dostępne tylko za pomocą POST w tej wersji obejmują:
/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) Zasady walidacji danych wejściowych po stronie klienta¶
Zalecana wstępna walidacja po stronie klienta:- dob i target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: Poprawny ciąg znaków IANA dla stref czasowych - top_n: Liczba całkowita w zakresie 1..31 - names[]: Minimum 2 wpisy do porównania marki - context dla dopasowania daty: Maksymalna długość 80, akceptowane znormalizowane aliasy
4) Wbudowane Schematy Żądania¶
Dla endpointów relacji i kompatybilności, używaj wyraźnych, wbudowanych obiektów, takich jak:
person_aperson_bparentchild
Każdy obiekt powinien zawierać wymagane pola, takie jak:
full_namedob
5) Obsługa Języka i Metadanych¶
Rozszerzone endpointy numerologii obsługują renderowanie odpowiedzi w wielu językach dzięki lang.
Obsługiwany zestaw języków dla sprawdzonych testów:
enesdefrpt
Odpowiedzi mogą zawierać opakowania metadanych w stylu korporacyjnym:
_enterprise_api_metadata_
Klient powinien zachować i przetworzyć te pola, gdy są przydatne do analizy platformy, informacji o planie lub metadanych endpointu.
6) Nowo Dodane Zakres Cykli¶
Klienci, którzy wcześniej używali tylko funkcji dotyczących dni/miesięcy/lat, mogą teraz rozszerzyć logikę harmonogramu, aby obejmować:- tygodniowe cykle osobiste przy użyciu /api/v1/personal-week - powierzchnie synchronizacji zbiorowej: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year
7) Dokumentacja jako źródło prawdy¶
Pełne strony integracji na poziomie endpointów dla tej wersji są utrzymywane w sekcji rozszerzonej dokumentacji, w tym strony indeksowe i dedykowane poszczególnym endpointom.
Numerology API — Zalecany Checklist Aktualizacji¶
- Przenieś złożone wywołania do bezpośredniego dostępu do API pod adresem
https://api.numerologyapi.com. - Upewnij się, że walidatory żądań wymuszają format daty, miesiąca i stref czasowej.
- Dodaj obsługę awaryjną dla wielojęzycznych wartości
langtam, gdzie jest to potrzebne. - Zaktualizuj klientów, aby konsekwentnie parsowały
_enterprisei_api_metadata_. - W przypadku endpointów wbudowanych, dopasuj modele żądań SDK do wymaganych kluczy obiektów.
- Waliduj przed promocją do środowiska produkcyjnego.
- Potwierdź, że wszystkie złożone wywołania są kierowane poza założenia klientów oparte na RapidAPI.
Numerology API — Podsumowanie Zmian w Wydaniu¶
Numerology API v1.0.0 wprowadza pełną rozszerzoną powierzchnię numerologii z rozszerzeniem cykli tygodniowych i uniwersalnych, zaawansowaną analizę relacji i duchową, bogatsze kontrakty żądań/odpowiedzi oraz w pełni zsynchronizowaną dokumentację, a także zgodność z testami smoke.# Część II — Rozszerzenie Horoskopu v1.0.0
Kluczowe cechy rozszerzenia horoskopu¶
- Ukończono migrację głównych przepływów raportów horoskopowych do wbudowanego silnika Swiss Ephemeris.
- Standaryzowano zaktualizowane punkty końcowe raportów wokół prośb POST jako pierwszego kroku.
- Dodano obsługę sekcji jako pierwszego elementu dla okresów dziennych, tygodniowych, miesięcznych i rocznych.
- Przeprojektowano punkty końcowe raportów planetarnych według okresu i równowagi między sekcjami/ogólnym przeglądem.
- Zmieniono nazwę punktu końcowego słownika planet na odzwierciedlenie jego informacyjnego zachowania, a nie zachowania raportu.
- Rozszerzono spójność z żądaniem natalnej karty urodzin i wzmocniono walidację kształtu odpowiedzi.
- Znormalizowano zaktualizowane odpowiedzi punktów końcowych do payload silnika plus otaczających go metadanych korporacyjnych.
- Zaktualizowano przykłady dokumentacji publicznej, aby zapewnić spójność JSON.
Rozszerzenie Horoskopu — Dodane Punkty Końcowe¶
A) Nowe Funkcje Pomocnicze i Standardowe Interfejsy¶
GET /api/v1/horoscope/timezones
B) Zestaw Raportów Planetarnych (Interfejs Okresowy)¶
Sekcje (nie ogólne):
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
Przegląd (tylko ogólny):
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
Rozszerzona obsługa sekcji planetarnych w różnych okresach obejmuje również sekcje obsługiwane przez silnik, takie jak:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples
C) Kompleks Raportów Aspektowych (Powierzchnia Okresowa)¶
Sekcje (nie ogólne):
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
Przegląd (tylko ogólny):
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/* obsługuje:
- tryb publiczny
- tryb spersonalizowany
- opcjonalną, deterministyczną zmianę
aspect - ten sam model sekcji używany w zaktualizowanych trasach horoskopowych
D) Kompleks Raportów Transitowych (Powierzchnia Okresowa)¶
Sekcje (nie ogólne):
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
Przegląd (tylko ogólny):
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/* obsługuje:
- tryb publiczny
- tryb spersonalizowany
- opcjonalną, deterministyczną zmianę
transit - ten sam model sekcji używany w zaktualizowanych trasach horoskopowych
E) Kompleks Raportów Domów (Tylko Spersonalizowane, Powierzchnia Okresowa)¶
Raporty domowe (sekcje nie ogólne):
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
Przeglądy domów (tylko ogólny):
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
Raporty planet-dom (sekcje nie ogólne):
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 personalized users and rely on engine endpoints such as:
/house-horoscope/planet-house-horoscope
F) Report Namespace Canonicalization¶
New 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.## Rozszerzenie Horoskopu – Zaktualizowane i Naprawione Punkty Konfiguracyjne
A) Migracja Silnika i Aktualizacje Zachowania¶
Następujące istniejące rodziny tras zostały zmodernizowane do zachowania opartego na wewnętrznym silniku:
Główny raport¶
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
Istniejące trasy kategorii zmodernizowane z zachowania opartego na legacy horoscope.com¶
- kariera
- zdrowie
- miłość
- pieniądze
Istniejące i legacy rodziny zrestrukturyzowane i zmodernizowane¶
- Trasy dotyczące miłości, wcześniej należące do legacy, podzielone na
love_singlesilove_couples - Połączone zachowanie
yearly/career_moneyzastąpione dedykowanymi trasami dla kariery i pieniędzy rocznych. - Trasy dotyczące raportów i przeglądów planet przeniesione do tras okresowych.
B) Jasne Definicje Trasy Opisu Znaku Zodiaku¶
Następujące punkty końcowe pozostają deskryptywnymi punktami końcowymi, a nie punktami końcowymi raportu w czasie rzeczywistym:
/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) Aktualizacja Parzystości Horoskopu urodzinowego¶
POST /api/v1/horoscope/reports/birthday teraz udostępnia klucze żądania native oparte na silniku, zachowując jednocześnie kompatybilne klucze.
Canonical zmodernizowana powierzchnia:
POST /api/v1/horoscope/reports/birthday
Zachowane ukryte aliasy kompatybilności:- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday
Dostępne klucze żądań natywnego silnika:
signtarget_datebirthsectionszodiac_systemayanamsahouse_systemnode_typetenant_id
Zachowano klucze kompatybilności:
dobtimezoneyearbirth_timebirth_latitudebirth_longitudebirth_timezone
D) Aktualizacja Diagramu Parity Narodzin¶
Te powierzchnie były dostępne przed wersją 1.0.0 i zostały zaktualizowane, aby zapewnić pełną zgodność z silnikiem:
POST /api/v1/birth-chartPOST /api/v1/birth-chart/svg
Zmiany obejmują:
- Pełne wsparcie dla opcji żądania "gateway to engine"
- Parity pola konfiguracji "wheel"
- Surowe mechanizmy kontroli kształtu odpowiedzi
E) Normalizacja Kontraktu Odpowiedzi¶
Zaktualizowane punkty końcowe oparte na silniku horoskopowym zwracają:
- Surowe dane payload z silnika
_enterprise_api_metadata_
F) Obsługa Stref Czasowych i Dni Odwzględnych¶
Punkty końcowe dziennie, wykorzystujące today, yesterday i tomorrow, teraz stosują rozwiązanie daty docelowej uwzględniające strefę czasową poprzez wejście IANA.
G) Jasne Uściślenie Obsługi Personalizacji¶
Gdzie jest to obsługiwane, raporty personalizowane są aktywowane poprzez dostarczanie pól "birth-vector", takich jak:
birth_timebirth_latitudebirth_longitudebirth_timezone
Jeśli zostaną pominięte, trasy pozostają używalne w ogólnym trybie opartym na znakach.## Rozszerzenie Horoskopu – Zdezaktywowane, Ukryte i Usuwane Punkty Konfiguracyjne| Endpoint | Status w wersji 1.0.0 | Zamiennik | Uwagi | |---|---|---|---| | Stara ścieżka raportu agregującego planety | Usunięta | Ścieżki okresowe pod /reports/planetary/ z ścieżkami specyficznymi dla okresu oraz odpowiadające im ścieżki /overview | Punkt wejściowy agregujący usunięto po zakończeniu spójności okresowej. | | POST /api/v1/horoscope/planetary/overview | Przestarzała (ukryta w 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 | Zastąpione ścieżkami przeglądowymi specyficznymi dla okresu. | | POST /api/v1/horoscope/planetary/daily/sections | Ukryta alias | POST /api/v1/horoscope/reports/planetary/daily | Alias dla kompatybilności wewnętrznej. | | POST /api/v1/horoscope/love_single/monthly | Przestarzały alias (ukryty) | POST /api/v1/horoscope/reports/love_singles/monthly | Zachowany ze względów kompatybilności. | | POST /api/v1/horoscope/weekly/retail | Przestarzała (ukryta w OpenAPI/dokumentacji) | Brak | Tygodniowy raport powierzchni handlowej usunięto z publicznej dokumentacji. | | Stara elastyczna ścieżka raportu agregującego horoskop | Usunięta | Ścieżki raportów specyficzne dla sekcji i ścieżki przeglądowe okresu | Punkt wejściowy agregujący usunięto po pełnym podziale endpointów. | | POST /api/v1/horoscope/yearly/career_money | Usunięta | POST /api/v1/horoscope/reports/career/yearly i POST /api/v1/horoscope/reports/money/yearly | Połączony podział endpointu na dedykowane ścieżki. | | POST /api/v1/horoscope/love/{today,tomorrow,yesterday} | Usunięte aktywne rejestrowanie | POST /api/v1/horoscope/reports/love_singles/daily/{today,tomorrow,yesterday} lub POST /api/v1/horoscope/reports/love_couples/daily/{today,tomorrow,yesterday} | "Dzienna miłość" została podzielona na kontekst relacji. || GET /api/v1/horoscope/planets i POST /api/v1/horoscope/planets | Zmienione/usunięte | GET /api/v1/horoscope/planets-info i POST /api/v1/horoscope/planets-info | Przeniesienie nazwy punktu końcowego w celu poprawy czytelności. |
Rozszerzenie Horoskopu — Zmiany powodujące przerwanie kompatybilności¶
- Zmiana nazwy trasy:
/api/v1/horoscope/planets→/api/v1/horoscope/planets-info - Canonicalny przestrzeń nazw dla raportów horoskopowych oparte na silniku to teraz
/api/v1/horoscope/reports/* - Połączone dziennie trasy miłosne zastąpione wyraźnymi trasami dla singli i par
- Połączona roczna trasa
career_moneyusunięta na rzecz dedykowanych tras rocznych - Ogólne raporty planetarne i punkty końcowe przeglądowe zastąpione trasami strukturowanymi według okresu
- Nowe trasy oparte na silniku zoptymalizowane pod kątem żądań POST
Rozszerzenie Horoskopu — Uwagi dotyczące kompatybilności¶
- Stare trasy
/api/v1/horoscope/report/*nadal dostępne jako ukryte aliasy zapewniające wsteczną kompatybilność - Publiczne dokumentacja i OpenAPI prezentują tylko canonicalną przestrzeń nazw
/api/v1/horoscope/reports/* - Nowe integracje powinny natychmiast korzystać z tras
/reports/*
Rozszerzenie Horoskopu — Uwagi dotyczące migracji¶
1) Mapa migracji ścieżek punktów końcowych- 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- Stara ścieżka agregująca planetarną:
POST /api/v1/horoscope/reports/planetary/{period}lub odpowiednik "ogólny przegląd" - Stara elastyczna ścieżka agregująca horoskop: ścieżki specyficzne dla sekcji lub ścieżki ogólne
POST /api/v1/horoscope/yearly/career_money→ podziel na roczne ścieżki kariery i finansowe- Stare codzienne ścieżki dotyczące miłości: podziel na
love_singleslublove_couples
2) Migracja Payloadu Żądania¶
Dla zaktualizowanych ścieżek opartych na silniku, użyj strukturalnych ciał POST z polami takimi jak:
dobtimezone- Selektory okresu, takie jak
day,target_datelubyear - Opcjonalne ustawienia silnika:
zodiac_systemayanamsahouse_systemnode_typetenant_id- Opcjonalne pola personalizacji:
birth_timebirth_latitudebirth_longitudebirth_timezone
3) Zasady Migracji Ścieżek Planetarnych¶
- Używaj
sectionstylko na nie-ogólnych ścieżkach planetarnych okresu generaljest dostępne poprzez dedykowane ścieżki/overview
4) Migracja Parsera Odpowiedzi¶
Klienci powinni parsować:
- pola payloadu raportu bezpośrednio z ciała odpowiedzi
_enterprise_api_metadata_
5) Uwaga dotycząca zachowania tłumaczeniaOprogramowanie do generowania horoskopów samo nie tworzy treści wielojęzycznej, więc punkty końcowe oparte na raportach obecnie obsługują tylko en.¶
Punkty końcowe, które nie są oparte na raportach, nadal obsługują pełną wielojęzyczną tłumaczenie za pomocą warstw pomocniczych bramki, korzystając z lang, takich jak:
enesdefrpt
Rozszerzenie horoskopu — Dokumentacja i Parity QA ukończone¶
- Zaktualizowano dokumentację dla zaktualizowanych tras horoskopów
- Stare dokumenty dotyczące planet zastąpiono dokumentami dotyczącymi konkretnych okresów
- Dokumentacja dotycząca kariery i finansów została podzielona, gdzie usunięto skomplikowane trasy
- Zsynchronizowano przykładowe JSON z odpowiedziami endpointów dla zaktualizowanej dokumentacji
Rozszerzenie horoskopu — Zalecany Checklist Aktualizacji Klienta¶
- Zaktualizuj wszystkie zmienione i przestarzałe ścieżki, korzystając z mapy migracji
- Przełącz dowolne stare konsumenty GET dla zaktualizowanych tras raportów na żądania POST w ciele
- Dodaj strefę czasową do wszystkich codziennych przepływów, aby uniknąć odchylenia dat
- Dodaj pola personalizacji, jeśli wymagane są edytoriale specyficzne dla użytkownika
- Zaktualizuj parsery odpowiedzi, aby zachować
_enterprisei_api_metadata_ - Przeprowadź ponowne testy integracyjne na wszystkich punktach końcowych horoskopu używanych w produkcji## Podsumowanie zmian w Horoskopie — Notatki
Numerology API v1.0.0 zapewnia kompleksowe wdrożenie, rozszerza zakres raportów na poszczególne sekcje i okresy, wprowadza czystszą strukturę standardowych tras oraz ustanawia jasną powierzchnię produkcyjną dla przyszłych iteracji wewnętrznego silnika horoskopowego.
Część III — Wytyczne dotyczące integracji między API¶
Jednolite notatki dotyczące integracji dla klientów korzystających z Numerology API¶
Klienci, którzy konsumują zarówno punkty końcowe Numerology, jak i punkty końcowe Horoskopu, powinni zapoznać się z następującymi informacjami:
Autentykacja i dostęp¶
- Rozszerzone punkty końcowe Numerology są dostępne tylko bezpośrednio (bez wsparcia RapidAPI)
- Punkty końcowe horoskopowe oparte na silniku również są dostępne bezpośrednio i kontynuują działanie w ramach swojego standardowego przestrzeni nazw API, z ulepszonymi wzorcami dostępu
- Zachowaj obsługę wrapperów metadanych w stylu korporacyjnym
Modelowanie żądań¶
- Preferuj jawne, strukturalne ciała POST dla wszystkich nowych tras, które zostały zaktualizowane lub rozszerzone
- Waliduj formaty dat, selektory okresów, ciągi stref czasowych i złożone obiekty po stronie klienta
- W miarę możliwości, dostarczaj wektory personalizacji w celu uzyskania bogatszych wyników### Czas i Semantyka Dat
- Endpoki Numerologii zależą od poprawnego formatu daty i miesiąca
- Dziennie trasy Horoskopowe zależą od prawidłowej obsługi stref czasowych w celu rozwiązywania problemów związanych z czasem
- Zaleca się używanie ciągów IANA, jeśli są dostępne
Obsługa Języków¶
- Rozszerzone endpoki Numerologii mają renderowanie w wielu językach, które zostało zweryfikowane
- Trasy Horoskopowe oparte na Engine nadal obsługują tylko
en
Rady dotyczące Wdrożenia Produkcyjnego¶
- Najpierw zaktualizuj SDK i walidatory żądań
- Następnie zaktualizuj testy integracyjne
- Następnie wprowadź zmiany w trasach/ścieżkach do klientów produkcyjnych
- Monitoruj wszelkie ukryte aliasy kompatybilności, które nadal są używane wewnętrznie, aby można je było bezpiecznie wyłączyć później
Część IV — Podsumowanie Ostatecznej Wersji¶
Co oznacza v1.0.0¶
v1.0.0 to punkt, w którym obie powierzchnie stają się znacznie bardziej kompletne i przyjazne dla produkcji:- Numerologia API teraz udostępnia znacznie bogatszy, rozszerzony katalog obejmujący takie obszary jak: timing, tożsamość, intuicja duchowa, praca z cieniem, relacje, kompatybilność oraz kalendarze predykcyjne. - Raporty astrologiczne opierają się teraz na znacznie bardziej solidnej bazie, wspartej przez standardowe nazwy przestrzeni raportów, szerszy zakres sekcji, jasne wzorce migracji i lepszą spójność między różnymi rodzinami raportów. - Dokumentacja, przykłady, zachowanie walidacji oraz wskazówki dotyczące kompatybilności są znacznie bardziej dojrzałe niż w stanie przed wersją 1.0.0.
Ta aktualizacja to nie tylko podwyższenie wersji. Jest to ustrukturyzowana aktualizacja, która poprawia:
- kompletność platformy
- jasność tras
- gotowość do migracji klienta
- pewność dokumentacji
- spójność integracji w przedsiębiorstwie
Rekomendacja operacyjna¶
Dla wszystkich aktywnych integratorów, zalecany jest następujący sposób:
- natychmiast przejście na standardowe trasy
- aktualizacja modeli żądań dla payloadów POST-first, tam gdzie to możliwe
- zachowanie parsowania otaczających metadanych
- walidacja formatów daty/stref czasowych po stronie klienta
- przeniesienie konsumentów rozszerzonych Numerology bezpośrednio do platformy
- ponowne uruchomienie pełnego testu integracji przed wdrożeniem