Extindere Numerologie + Extindere Horoscop v1.0.0 – Istoric de Schimbări Unificat¶

Data lansării: 2026-04-12 Versiune: v1.0.0 Scop: Lansare completă a platformei, acoperind Numerology API, Extindere Horoscop: inclusiv implementarea extensivă a endpointurilor, migrarea rapoartelor de horoscop bazată pe motor, normalizarea cererilor/răspunsurilor, paritate documentație, validare multilingvistică și ghiduri de integrare în producție.

Prezentare generală¶

v1.0.0 este o lansare majoră în producție pe platforma Dakidarts API. Aceasta aduce împreună două linii mari de dezvoltare într-o implementare coordonată:

1. Extindere Numerologie
2. Adaugă suprafața completă extinsă a numerologiei.
3. Extinde acoperirea temporală/ciclică cu săptămâna personală și ziua/săptămâna/luna/anul universal.
4. Introduce endpointuri mai profunde pentru analiza spirituală, relațională, identitate și umbre.
5. Finalizează paritatea documentației, exemple de răspunsuri și validare multilingvistică.2. Extinderea Horoscopului
6. Finalizează migrarea majoră a generării rapoartelor de horoscop către motorul Swiss Ephemeris intern.
7. Standardizează rutele de raport bazate pe motor sub /api/v1/horoscope/reports/*.
8. Adaugă acoperire largă pentru perioade zilnice, săptămânale, lunare și anuale.
9. Introduce pachete de rapoarte periodizate cu planete, aspecte, tranzite și case.
10. Îmbunătățește consistența payload-ului, comportamentul de personalizare, aliasurile de compatibilitate și coerența documentației.

Acest jurnal de modificări este destinat să servească ca sursă unică de adevăr pentru integratori, revizuirea internă a lansării, suport, planificarea migrării și comunicarea cu clienții în timpul lansărilor.

Puncte Cheie la Nivelul Platformei¶

Ce oferă v1.0.0 pe toată platforma¶

• Lansare majoră v1.0.0 pentru producție atât pentru Numerology API, cât și pentru Horoscope API.
• Extindere semnificativă a suprafeței endpoint-urilor în produsele de numerologie și horoscop.
• Finalizarea migrării calculului horoscopic bazat pe motor pentru fluxurile principale de raportare.
• Finalizarea track-ului de lansare Extended Numerology.
• Îmbunătățirea modelelor de cereri structurate, cu POST ca prioritate, pentru rutele actualizate de horoscop.
• Suport mai larg pentru payload-uri bogate de răspuns, wrapper-e enterprise și consistența metadatelor.
• Paritate mai mare a documentației între documentele publice și payload-urile de exemplu.
• Validare multilingvă reușită pentru endpoint-urile extinse de numerologie.
• Îmbunătățirea clarității rutei, gestionarea compatibilității și ghidul de migrare pentru clienții de producție.
• Suport extins pentru calculări personalizate, unde sunt furnizate vectorii de naștere și câmpuri avansate de cerere.
• Îmbunătățirea clarității operaționale în ceea ce privește fusul orar, sistemul zodiacal, ayanamsa, sistemele de case și comportamentul nodurilor în fluxurile de cereri de horoscop.

Rezumat al Compoziției Lansării¶

Extindere Numerologie¶

• Familii de endpoint-uri noi adăugate: 23
• Operații combinate adăugate (GET/POST): 41
• Cereri de validare/smoke executate: 205
• Documentare multilinguală cu succes: 100.0%
• Model extins de lansare: additive, fără deprecări formale în noua suită extinsă

Extindere Horoscop¶

• Rapoarte majore migrate către motorul intern
• Noi suite de rapoarte adăugate pentru:
• planetar
• aspecte
• transite
• casă
• planetă-casă
• Namespace de raport standardizat sub:
• /api/v1/horoscope/reports/*
• Mai multe rute legacy păstrate ca aliasuri de compatibilitate ascunse, în timp ce documentația publică continuă cu căile standard

Partea I — API Numerologie v1.0.0¶

Puncte cheie ale Extinderii Numerologie¶

• Am adăugat documentația completă a Numerologiei Extinse în secțiunea de documentație extinsă.
• Am adăugat și am finalizat Săptămâna Personală, cu paritate completă GET/POST și suport pentru payloaduri de răspuns bogate.
• Am adăugat și am finalizat Extensiile Ciclului Universal:
• Zi Universală
• Săptămână Universală
• Lună Universală
• An Universal
• Am standardizat documentația endpointurilor extinse, cu tabele complete de parametri, opțiuni, exemple de răspuns și legături către endpointuri relevante.
• Am confirmat acoperirea multilingvă în en, es, de, fr, pt la 100% succes pentru operațiuni extinse.
• Am clarificat modelul de acces: endpointurile extinse sunt accesibile doar prin platformă și nu sunt suportate în prezent prin gateway-ul RapidAPI.

Extindere Numerologică — Endpointuri Noi Adăugate¶

Această versiune adaugă 23 familii de endpointuri extinse și 41 operațiuni (GET/POST combinate).

A) Endpointuri pentru Cicluri și Timp¶

B) Endpoints pentru Identitate și Inteligență de Nume¶

C) Endpoints pentru Analiză Spirituală și de Umbre¶

D) Endpoint-uri pentru Dinamica Relațiilor¶

API de Numerologie — Endpoint-uri Actualizate și Corecte¶

A) Suprafațe Noi, Extinse, Finalizate¶

Următoarele suprafețe noi au fost finalizate integral în acest ciclu de lansare, cu validarea cererilor și output bogat de semnificație:

• GET /api/v1/personal-week
• POST /api/v1/personal-week
• GET /api/v1/universal-year
• POST /api/v1/universal-year
• GET /api/v1/universal-month
• POST /api/v1/universal-month
• GET /api/v1/universal-week
• POST /api/v1/universal-week
• GET /api/v1/universal-day
• POST /api/v1/universal-day

B) Corecturi de Stabilitate Aplicate în timpul Validării Inițiale¶

Cinci operații care inițial produceau 422 în cazul intrărilor generate de fum au fost stabilizate pentru acoperire completă a testelor, similare cu cele din producție, și acum returnează răspunsuri reușite în mai multe limbi: - POST /api/v1/brand-name-compare - GET /api/v1/caution-dates-calendar - POST /api/v1/caution-dates-calendar - GET /api/v1/monthly-energy-heatmap - POST /api/v1/monthly-energy-heatmap

C) Reguli de Validare Practice Aplicate¶

Următoarele restricții au fost strânse și clarificate în timpul procesului de validare și documentare: - Compararea mărkilor necesită cel puțin două intrări în names[].- Inputurile pentru calendar și harta termică folosesc formatul YYYY-MM.- Atenție: datele pentru „Caution dates” top_n rămân în intervalul 1..31.- Payload-urile clientului beneficiază de validare preliminară înainte de trimitere pentru a reduce erorile inutile 422 sau erorile la nivel de format.

D) Corectarea Inconsistențelor în Documentație și OpenAPI¶

Toate documentele extinse au fost normalizate pentru a asigura compatibilitatea integrării: - completați tabelele cu parametri pentru fiecare metodă- detalii despre opțiunile parametrilor- modele, intervale, valori implicite și câmpuri de obiecte imbricate- exemple de secțiuni cu răspunsuri bogate, bazate pe payload-uri generate prin simulare

---- note despre acces și disponibilitate standardizate

---- butonul de acțiune (CTA) pentru panoul principal, secțiuni cu note și footer-uri aferente endpoint-urilor

---¶

Numerology API — Verificare de Calitate¶

Artefacte de validare pentru suite-ul extins de numerologie:

• Fișiere de sumar: 23
• Operațiuni testate: 41
• Număr total de cereri executate: 205
• Rata generală de succes: 100.0%
• Succes în limbaj:
• en — 100%
• es — 100%
• de — 100%
• fr — 100%
• pt — 100%

Această versiune încheie ciclul de lansare al suite-ului extins de numerologie, oferind încredere în validarea completă a setului de limbaje documentat.

Numerology API — Deprecieri¶

Pentru versiunea Numerology Extended v1.0.0, niciun endpoint din suprafața extinsă nu este formal depreciat.

Numerology API — Modificări care necesită actualizare¶

Nu sunt introduse eliminări de căi de impact pentru suprafața de numerologie extinsă în această versiune.

Cu toate acestea, integratorii ar trebui să ia în considerare următoarele așteptări la nivelul lansării:- Endpoint-urile extinse nu sunt disponibile prin RapidAPI în acest moment. - Clienții care integrează endpoint-urile extinse ar trebui să țintească serverul direct al platformei. - Unele endpoint-uri noi sunt disponibile doar cu POST și nu trebuie presupus că au compatibilitate cu GET.

Numerology API — Note de migrare¶

1) Migrarea canalului de acces¶

Endpoint-urile extinse sunt disponibile prin acces direct la platformă:

• URL de bază: https://api.numerologyapi.com
• Autentificare:
• X-API-Key: YOUR_API_KEY
• sau Authorization: Bearer YOUR_API_KEY

Endpoint-urile extinse nu sunt în prezent suportate prin gateway-ul RapidAPI.

2) Ghid de utilizare GET vs POST¶

Majoritatea endpoint-urilor extinse suportă atât GET, cât și POST cu intenție de ieșire echivalentă.

Utilizați:

• GET pentru apeluri simple bazate pe interogare
• POST pentru structură mai puternică a payload-ului, obiecte imbricate și consistență cu SDK/backend

Endpoint-urile care acceptă doar POST în această versiune includ:

• /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) Reguli de validare a intrărilor pe partea clientului¶

Validarea prealabilă recomandată pe partea clientului:- dob și target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: șir valid IANA de fus orar - top_n: număr întreg în intervalul 1..31 - names[]: minimum 2 intrări pentru compararea mărcilor - context pentru alinierea datei: lungime maximă 80, alias normalizate acceptate

4) Modele de Corpuri de Cereri Aninăte¶

Pentru endpointurile de relație și compatibilitate, utilizați obiecte aninăte explicite, cum ar fi:

• person_a
• person_b
• parent
• child

Fiecare obiect ar trebui să includă câmpurile obligatorii, cum ar fi:

• full_name
• dob

5) Gestionarea Limbajului și a Metadatelor¶

Endpointurile extinse de numerologie suportă redarea răspunsurilor multilingve prin intermediul lang.

Setul de limbaje acceptat pentru acoperire verificată:

• en
• es
• de
• fr
• pt

Răspunsurile pot include înveliuri de metadate în stil enterprise:

• _enterprise
• _api_metadata_

Клиентите ar trebui să păstreze și să parseze aceste câmpuri, acolo unde este util pentru analiza platformei, informații despre plan sau metadate ale endpointului.

6) Acoperire Nou Adăugată a Ciclu¶

Клиентите care anterior utilizau doar fluxurile de zi/lună/an personale pot acum extinde logica programului pentru a acoperi:- cicluri personale săptămânale prin /api/v1/personal-week - suprafețe de sincronizare colectivă prin: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year

7) Sursa de Documentație Oficială¶

Paginile complete de integrare la nivel de endpoint pentru această versiune sunt menținute în secțiunea extinsă de documentație, inclusiv paginile index și per-endpoint.

Numerology API — Checklist Recomandat de Actualizare¶

• Mută apelurile extinse către accesul direct la API la https://api.numerologyapi.com.
• Asigură-te că validatorii de cerere impun formate pentru data, lună și fus orar.
• Adaugă gestionarea de rezervă pentru valorile multilingve lang acolo unde este necesar.
• Actualizează clienții pentru a analiza consistent _enterprise și _api_metadata_.
• Pentru endpoint-uri imbricate, aliniază modelele de cerere SDK cu cheile obiectului necesare.
• Validează folosind fixture-uri de test înainte de promovarea în producție.
• Confirmă că toate apelurile extinse sunt rutate în afara presupunerilor clienților bazate pe RapidAPI.

Numerology API — Rezumat al Notelelor de Lansare¶

Numerology API v1.0.0 introduce suprafața complet extinsă de numerologie, cu expansiunea ciclurilor săptămânale și universale, analize avansate ale relațiilor și spirituale, contracte îmbunătățite pentru cereri/răspunsuri, plus documentație complet sincronizată și paritate cu testele de fum.# Partea a II-a — Extinderea Horoscopului v1.0.0

Principalele caracteristici ale Extinderii Horoscopului¶

• Finalizarea migrării fluxurilor principale de generare a rapoartelor horoscopice către motorul Swiss Ephemeris intern.
• Standardizarea endpoint-urilor de raport actualizate în jurul cererilor cu corpuri de date POST-first.
• Adăugarea unei acoperiri largi bazată pe secțiuni pentru perioadele zilnice, săptămânale, lunare și anuale.
• Restructurarea endpoint-urilor de raport planetar în funcție de periodă și de echivalența secțiunii/prezentării generale.
• Renumirea endpoint-ului glosariului planetelor pentru a reflecta comportamentul său informativ, mai degrabă decât comportamentul de raportare.
• Extinderea parității cererilor de harta natală și strângerea validării formei răspunsului.
• Normalizarea răspunsurilor endpoint-urilor actualizate la payload-ul motorului plus înveliuri de metadate enterprise.
• Actualizarea exemplelor din documentația publică cu paritate JSON susținută.

Extinderea Horoscopului — Noi Endpoint-uri Adăugate¶

A) Noi Suprafațe și Ajutor¶

• GET /api/v1/horoscope/timezones

B) Suita de Rapoarte Planetare (Suprafață Periodizată)¶

Secțiuni (non-generale):

• POST /api/v1/horoscope/reports/planetary/daily
• POST /api/v1/horoscope/reports/planetary/weekly
• POST /api/v1/horoscope/reports/planetary/monthly
• POST /api/v1/horoscope/reports/planetary/yearly

Prezentare generală (doar general):

• 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

Acoperirea extinsă a secțiunilor planetare în funcție de perioade include secțiuni suportate de motor, cum ar fi:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples

C) Suită de Rapoarte privind Aspectele (Suprafață Periodizată)¶

Secțiuni (non-generale):

• POST /api/v1/horoscope/reports/aspects/daily
• POST /api/v1/horoscope/reports/aspects/weekly
• POST /api/v1/horoscope/reports/aspects/monthly
• POST /api/v1/horoscope/reports/aspects/yearly

Prezentare generală (doar general):

• POST /api/v1/horoscope/reports/aspects/daily/overview
• POST /api/v1/horoscope/reports/aspects/weekly/overview
• POST /api/v1/horoscope/reports/aspects/monthly/overview
• POST /api/v1/horoscope/reports/aspects/yearly/overview

aspects/* suportă:

• modul public
• modul personalizat
• suprascriere deterministă opțională a aspect
• același model de secțiune utilizat în rutele de horoscope actualizate

D) Suită de Rapoarte privind Tranzitele (Suprafață Periodizată)¶

Secțiuni (non-generale):

• POST /api/v1/horoscope/reports/transits/daily
• POST /api/v1/horoscope/reports/transits/weekly
• POST /api/v1/horoscope/reports/transits/monthly
• POST /api/v1/horoscope/reports/transits/yearly

Prezentare generală (doar general):

• POST /api/v1/horoscope/reports/transits/daily/overview
• POST /api/v1/horoscope/reports/transits/weekly/overview
• POST /api/v1/horoscope/reports/transits/monthly/overview
• POST /api/v1/horoscope/reports/transits/yearly/overview

transits/* suportă:

• modul public
• modul personalizat
• suprascriere deterministă opțională a transit
• același model de secțiune utilizat în rutele de horoscope actualizate

E) Suită de Rapoarte privind Casele (Doar Personalizate, Suprafață Periodizată)¶

Rapoarte privind casele (secțiuni non-generale):

• POST /api/v1/horoscope/reports/house/daily
• POST /api/v1/horoscope/reports/house/weekly
• POST /api/v1/horoscope/reports/house/monthly
• POST /api/v1/horoscope/reports/house/yearly

Prezentări generale privind casele (doar general):

• POST /api/v1/horoscope/reports/house/daily/overview
• POST /api/v1/horoscope/reports/house/weekly/overview
• POST /api/v1/horoscope/reports/house/monthly/overview
• POST /api/v1/horoscope/reports/house/yearly/overview

Rapoarte privind planetele și casele (secțiuni non-generale):

• POST /api/v1/horoscope/reports/planet/house/daily
• POST /api/v1/horoscope/reports/planet/house/weekly
• POST /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/overview
• POST /api/v1/horoscope/reports/planet/house/monthly/overview
• POST /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) Report Namespace Canonicalization¶

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/today
• POST /api/v1/horoscope/reports/communication/daily/tomorrow
• POST /api/v1/horoscope/reports/communication/daily/yesterday
• POST /api/v1/horoscope/reports/communication/weekly
• POST /api/v1/horoscope/reports/communication/monthly
• POST /api/v1/horoscope/reports/communication/yearly

Friendship¶

• POST /api/v1/horoscope/reports/friendship/daily/today
• POST /api/v1/horoscope/reports/friendship/daily/tomorrow
• POST /api/v1/horoscope/reports/friendship/daily/yesterday
• POST /api/v1/horoscope/reports/friendship/weekly
• POST /api/v1/horoscope/reports/friendship/monthly
• POST /api/v1/horoscope/reports/friendship/yearly

Lifestyle¶

• POST /api/v1/horoscope/reports/lifestyle/daily/today
• POST /api/v1/horoscope/reports/lifestyle/daily/tomorrow
• POST /api/v1/horoscope/reports/lifestyle/daily/yesterday
• POST /api/v1/horoscope/reports/lifestyle/weekly
• POST /api/v1/horoscope/reports/lifestyle/monthly
• POST /api/v1/horoscope/reports/lifestyle/yearly

Love Split Surfaces (Singles/Couples)¶

• POST /api/v1/horoscope/reports/love_singles/daily/today
• POST /api/v1/horoscope/reports/love_singles/daily/tomorrow
• POST /api/v1/horoscope/reports/love_singles/daily/yesterday
• POST /api/v1/horoscope/reports/love_singles/weekly
• POST /api/v1/horoscope/reports/love_singles/monthly
• POST /api/v1/horoscope/reports/love_couples/daily/today
• POST /api/v1/horoscope/reports/love_couples/daily/tomorrow
• POST /api/v1/horoscope/reports/love_couples/daily/yesterday
• POST /api/v1/horoscope/reports/love_couples/weekly
• POST /api/v1/horoscope/reports/love_couples/monthly

Yearly Section Additions¶

• POST /api/v1/horoscope/reports/health/yearly
• POST /api/v1/horoscope/reports/money/yearly

H) Renamed Informational Planets Surface¶

• GET /api/v1/horoscope/planets-info
• POST /api/v1/horoscope/planets-info

This replaces the previous /horoscope/planets naming for the informational glossary-style behavior.

Expansiunea Horoscopică – Endpoint-uri Actualizate și Corecte¶

A) Migrarea Motorului și Actualizări de Comportament¶

Următoarele familii de rute existente au fost actualizate pentru a utiliza un motor intern:

Rute principale pentru rapoarte¶

• POST /api/v1/horoscope/reports/today
• POST /api/v1/horoscope/reports/yesterday
• POST /api/v1/horoscope/reports/tomorrow
• POST /api/v1/horoscope/reports/weekly
• POST /api/v1/horoscope/reports/monthly
• POST /api/v1/horoscope/reports/yearly

Rute de categorie existente, actualizate din comportamentul vechi al horoscope.com¶

• carieră
• sănătate
• dragoste
• bani

Familii existente și vechi restructurate și actualizate¶

• Rutele vechi de "dragoste" separate în love_singles și love_couples
• Comportamentul combinat yearly/career_money înlocuit cu rute dedicate anuale pentru carieră și bani
• Rutele vechi de rapoarte și prezentare planetară mutate în rute periodizate

B) Clarificarea Rutei Descrierii Semnului Zodiacal¶

Următoarele suprafețe rămân endpoint-uri descriptive de semne, nu endpoint-uri pentru rapoarte live:

• /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) Actualizarea Parității Raportului de Aniversare¶

POST /api/v1/horoscope/reports/birthday expune acum chei native ale motorului, menținând în același timp compatibilitatea.

Suprafață canonică actualizată:

• POST /api/v1/horoscope/reports/birthday

Alias-uri de compatibilitate ascunse păstrate:- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday

Chei de cerere native pentru motor:

• sign
• target_date
• birth
• sections
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id

Chei de compatibilitate păstrate:

• dob
• timezone
• year
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

D) Actualizare Paritate a Hărții Nașterii¶

Aceste interfețe au existat înainte de v1.0.0 și sunt acum actualizate pentru o paritate completă cu motorul:

• POST /api/v1/birth-chart
• POST /api/v1/birth-chart/svg

Îmbunătățirile includ:

• Suport complet pentru opțiunea de cerere "gateway to engine"
• Paritate a câmpului de configurare "wheel"
• Garduri mai stricte pentru forma răspunsului

E) Normalizarea Contractului de Răspuns¶

Endpoint-urile actualizate, bazate pe motorul Horoscope, returnează:

• payload-ul original al motorului
• _enterprise
• _api_metadata_

F) Gestionarea Timpului și a Zilelor Relative¶

Endpoint-urile zilnice care utilizează today, yesterday și tomorrow aplică acum rezolvarea țintă cu conștientizarea fusului orar prin input-ul IANA de fus orar.

G) Clarificarea Suportului pentru Personalizare¶

Dacă este suportat, rapoartele personalizate sunt activate furnizând câmpurile "birth vector", cum ar fi:

• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

Dacă sunt omise, rutele rămân utilizabile în modul generalizat bazat pe semn.

Extinderea Horoscopului – Endpoint-uri Deprecate, Ascunse și Eliminate¶

Extindere Horoscop — Modificări incompatibile¶

• Renunțarea la rută: /api/v1/horoscope/planets → /api/v1/horoscope/planets-info
• Namespace-ul canonic pentru rapoartele horoscopice bazate pe motor este acum /api/v1/horoscope/reports/*
• Rutele zilnice combinate de dragoste înlocuite cu căi specifice pentru singuri și perechi
• Rută combinată anuală career_money eliminată în favoarea rutelor anuale dedicate
• Endpoint-urile generale de raportare planetară și de prezentare înlocuite cu rute structurate pe perioadă
• Rutele bazate pe motor, actualizate, standardizate în jurul corpului de cereri POST

Extindere Horoscop — Note de compatibilitate¶

• Rutele legacy /api/v1/horoscope/report/* rămân disponibile ca alias-uri ascunse, compatibile înapoi
• Documentația publică și OpenAPI prezintă acum doar namespace-ul canonic /api/v1/horoscope/reports/*
• Noile integrări ar trebui să adopte imediat căile /reports/*

Extindere Horoscop — Note de migrare¶

1) Harta de migrare a căilor endpoint¶

• 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
• Rută de agregare planetară veche → POST /api/v1/horoscope/reports/planetary/{period} sau echivalent "prezentare generală"
• Rută flexibilă de agregare a horoscopului veche → rute specifice secțiunii sau rute de tip "prezentare generală"
• POST /api/v1/horoscope/yearly/career_money → împărțire în rute anuale pentru carieră și rute anuale pentru bani
• Rute zilnice de tip "dragoste" vechi → împărțire în love_singles sau love_couples (rute zilnice)

2) Migrarea Corpului Cererii¶

Pentru rutele îmbunătățite, folosiți corpuri POST structurate cu câmpuri precum:

• dob
• timezone
• Selectoare de perioadă, cum ar fi day, target_date sau year
• Opțiuni suplimentare pentru motor:
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id
• Câmpuri de personalizare opționale:
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

3) Reguli de Migrare a Rutelor Planetare¶

• Folosiți sections doar pe rutele planetare de tip "prezentare generală"
• general este expusă prin intermediul rutelor dedicate /overview

4) Migrarea Parserului de Răspuns¶

Клиентите ar trebui să parseze:

• Câmpurile din corpul răspunsului
• _enterprise
• _api_metadata_

5) Notă privind Comportamentul de Traducere¶

Motorul de horoscop nu generează direct conținut multilingv, așa că punctele finale de raportare suportă în prezent doar en. Non-report endpoints continue to support full multilingual translation through gateway helper layers using lang, such as:

• en
• es
• de
• fr
• pt

Extinderea Horoscopului – Documentație și Echilibru Calitate-Performanță Finalizate¶

• Documentația publică actualizată pentru rutele de horoscop îmbunătățite

---- Documentația istorică privind planetele a fost înlocuită cu documentație specifică pentru fiecare perioadă

---- Documentația privind cariera și finanțele a fost împărțită, unde au fost eliminate rutele combinate

---- Exemplu JSON cu suport pentru "smoke tests", sincronizat cu răspunsurile endpoint-urilor, pentru documentație îmbunătățită¶

Extinderea Horoscopului – Lista de Verificare pentru Actualizarea Recomandată a Clienților¶

• Actualizați toate căile redenumite și învechite folosind harta de migrare

---- Schimba orice consumatori vechi de tip GET care utilizează rutele de raport actualizate pentru a utiliza cereri cu corp (POST)- Adăugați faza orară tuturor fluxurilor zilnice pentru a evita deriva relativă a datelor

---- Adăugați câmpuri de personalizare unde sunt dorite articole specifice utilizatorului

---- Actualizați parserii de răspuns pentru a păstra _enterprise și _api_metadata_- Repetați testele de integrare împotriva tuturor endpointurilor de horoscop utilizate în producție

---¶

Rezumat al Noteelor de Lansare – Expansiunea Horoscopului¶

Numerology API v1.0.0 finalizează implementarea majoră cu funcționalitate completă, extinde acoperirea rapoartelor în secțiuni și perioade, introduce o structură mai clară a rutelor canonice și stabilește o suprafață de producție mai clară pentru iterațiile viitoare ale motorului intern de horoscop.

Partea III — Ghid de Integrare Trans-API¶

Notee de Integrare Unificate pentru Clienții care Utilizează Numerology API¶

Clienții care consumă atât punctele finale Numerology, cât și punctele finale Horoscope ar trebui să revizuiască următoarele împreună:

Autentificare și Acces¶

• Punctele finale Numerology sunt disponibile doar direct (fără suport pentru gateway RapidAPI)
• Rutelor motorului de horoscop sunt, de asemenea, disponibile doar direct și continuă sub spațiul lor API canonice cu modele de gateway actualizate
• Menține suport pentru wrapper-e de metadate în stil enterprise

Modelarea Cererilor¶

• Preferă corpurile POST structurate explicit pentru toate rutele nou actualizate sau extinse
• Validează formate de dată, selectoare de perioade, șiruri de fus orar și obiecte imbricate pe partea client
• Unde este disponibil, furnizează vectori de personalizare pentru rezultate mai bogate

Timp și Semantica Datelor¶

• Endpoint-urile Numerology depind de formate corecte pentru data și lună
• Rutinele zilnice Horoscope depind de gestionarea corectă a fusului orar pentru rezolvarea relativă a zilelor
• Se recomandă puternic utilizarea șirurilor IANA de fusuri orare, acolo unde este suportat

Gestionarea Limbajelor¶

• Endpoint-urile extinse Numerology au afișare multilinguală verificată
• Rutinele Horoscope, bazate pe Engine, continuă să suporte doar en

Sfaturi pentru Lansarea în Producție¶

• actualizați SDK-urile și validatoarele de cereri mai întâi
• reîncercați testele de integrare a doua
• apoi promovați modificările rutelor/căilor către clienții de producție
• monitorizați orice aliasuri de compatibilitate ascunse încă utilizate intern, astfel încât să le puteți elimina în siguranță ulterior

Partea IV — Rezumatul Lansării Finale¶

Ce înseamnă v1.0.0¶

v1.0.0 este punctul în care ambele suprafețe devin mult mai complete și potrivite pentru producție:```markdown - API-ul Numerologie expune acum un catalog mult mai bogat și extins, cuprinzând aspecte precum timpul, identitatea, perspectiva spirituală, lucrul cu umbrele, relațiile, compatibilitatea și calendarele predictive. - Rapoartele de horoscop se bazează acum pe o fundație mult mai solidă, oferind spații de nume canonice, acoperire mai largă a secțiunilor, patternuri de migrare mai clare și o compatibilitate îmbunătățită între familiile de rapoarte. - Documentația, exemplele, comportamentul de validare și ghidurile de compatibilitate sunt mult mai mature decât în starea pre-v1.0.0.

Această lansare nu este doar un increment de versiune. Este o lansare structurală care îmbunătățește:

• completitudinea platformei
• claritatea rutelor
• pregătirea pentru migrarea clienților
• încrederea în documentație
• consistența integrării enterprise

Recomandări operaționale¶

Pentru toți integratorii activi, calea recomandată este:

1. adoptați imediat rutele canonice
2. actualizați modelele de cerere pentru payload-uri POST, acolo unde este cazul
3. păstrați parsarea wrapper-ului de metadate
4. validați formatele de fus orar/dată pe partea client
5. mutați consumatorii extinsi de Numerology către acces direct la platformă
6. rulați din nou testele complete de acoperire a integrării înainte de lansarea în producție

Notă finală¶

Acest jurnal de modificări unificat reflectă starea versiunii v1.0.0 pentru The Numerology API și consolidează principalele activități de lansare finalizate în perioada de lansare 2026-04-12.