Numerology API v1.0.1 - Zmiany¶

Data wydania: 2026-06-08 Wersja: v1.0.1 Zakres: Rozszerzenie punktów końcowych Numerology API, obsługa numerologii w wielu systemach, rozszerzona lokalizacja znaczenia JSON, czyszczenie tras i spójność dokumentacji.

Ogólny przegląd wydania¶

v1.0.1 to wydanie produkcyjne, które dodaje funkcjonalności do Numerology API. Bazuje na rozszerzonej implementacji numerologii z wersji v1.0.0, dodając głębsze interpretacje imion, czasu, biznesu, decyzji, rodziny, zespołu, pieniędzy i archetypów.

To wydanie koncentruje się na czterech głównych celach:

1. Szeroki zakres punktów końcowych
2. Dodaje 10 nowych rodzin punktów końcowych.
3. Każdy nowy punkt końcowy obsługuje zarówno GET, jak i POST.

4. Wszystkie nowe punkty końcowe wykorzystują czyste publiczne trasy pod /api/v1/*.

5. Numerologia w wielu systemach

6. Nowe punkty końcowe oparte na imieniu obsługują opcjonalne num_sys.
7. Obsługiwane systemy:
   • pythagorean
   • chaldean
   • vedic
8. pythagorean pozostaje domyślny, aby zachować istniejące zachowanie.3. Rozszerzony zakres obsługiwanych języków
9. Obsługiwane języki odpowiedzi obejmują teraz:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja

10. Nowe rodziny punktów końcowych zawierają pliki JSON z lokalizacją dla wszystkich 8 obsługiwanych języków.

11. Dokumentacja i gotowość do wydania

12. Dodaje dokumentację integracji dla wszystkich 10 nowych rodzin punktów końcowych.
13. Aktualizuje indeks "Rozszerzone Punkty Końcowe".
14. Dokumentuje zachowanie GET, POST, lang i num_sys.
15. Weryfikuje widoczność ścieżek, pokrycie JSON oraz stabilność zestawu testów przy użyciu Python 3.11.

Walidacja zakończona dla tej wersji:

• Pełny zestaw testów w Pythonie: 137 passed
• Sprawdzenie ścieżek OpenAPI: wszystkie 10 czystych ścieżek obecne
• Nowe ścieżki /api/v1/extended/*: nie są zamontowane
• Walidacja tłumaczenia JSON: 8 folderów językowych, po 444 pliki w każdym, brak niezgodności strukturalnej
• Dostępne foldery z definicjami JSON: 8 języków × 444 pliki w każdym

Nowe¶

Nowe Rodziny Punktów Końcowych¶

v1.0.1 dodaje 10 nowych rodzin punktów końcowych i 20 operacji.| Endpoint | Metody | Ścieżka | |---|---|---| | Numerologia ścieżki kariery | GET, POST | /api/v1/career-path-numerology | | Czytanie kodu dotyczącego bogactwa | GET, POST | /api/v1/wealth-code-reading | | Numerologia adresu zamieszkania | GET, POST | /api/v1/home-address-numerology | | Prognoza imienia dziecka | GET, POST | /api/v1/baby-name-forecast | | Numerologia dynamiki zespołu | GET, POST | /api/v1/team-dynamics-numerology | | Numerologia nazwy domeny | GET, POST | /api/v1/domain-name-numerology | | Numerologia nazwy produktu | GET, POST | /api/v1/product-name-numerology | | Czytanie "punktów decyzyjnych" | GET, POST | /api/v1/decision-crossroads-reading | | Numerologia czasu uruchomienia | GET, POST | /api/v1/launch-timing-numerology | | Struktura archetypu osobistego | GET, POST | /api/v1/personal-archetype-stack |

Nowa infrastruktura wspólnego endpointu¶

Wersja v1.0.1 dodaje wspólną logikę pomocniczą dla nowych rozszerzonych endpointów numerologii, w tym:

• Ładowanie lokalizowanego pliku JSON
• Wyszukiwanie konfiguracji endpointu
• Wyszukiwanie znaczenia i szczegółowego znaczenia
• Obliczanie profilu imienia
• Pomocniki numerologii daty urodzenia
• Pomocniki scoringowe
• Śledzenie użytkowania
• Owijanie odpowiedzi dla przedsiębiorstw
• Ponowne wykorzystanie autoryzacji żądania

Wzmocnienie systemu NumerologiiThe shared numerology-system helper now includes explicit, validated letter tables for all supported systems:¶

• pythagorean
• chaldean
• vedic

The Vedic table is supported for Latin-transliterated names and is kept separate from Chaldean even though both systems use the same A-Z values in v1.0.1. Common Latin diacritics and ligatures are normalized before name calculation, and missing-name-value helpers now respect each system's actual alphabet value range.

Nowe Zakresy Testów¶

Nowe testy obejmują:

• zachowanie kalkulatora dla 10 rodzin punktów końcowych

---- Obsługa systemu numerologii dla chaldean i vedic- Obsługa polityki wsparcia dla 8 języków

---- wyszukiwanie znaczenia w języku lokalnym- Widoczność ścieżek w OpenAPI

---- kształt ścieżki bez /extended¶

Poprawki¶

Czyszczenie ścieżek¶

Nowe rodziny punktów końcowych używają wyłącznie czystych, publicznych ścieżek: - Poprawna: /api/v1/career-path-numerology- Poprawna: /api/v1/wealth-code-reading- Poprawna: /api/v1/personal-archetype-stack The draft /api/v1/extended/* route shape for these 10 new endpoint families is not mounted and does not appear in OpenAPI.

Poprawki w Polityce Językowej¶

Zasady dotyczące wspólnego języka obejmują teraz wszystkie 8 obsługiwanych języków: - en - es - de - fr - pt - ar - hi - ja

Istniejąca wyjątkowa sytuacja z raportem horoskopowym pozostaje niezmieniona: trasy oparte na silniku /api/v1/horoscope/reports/* nadal obsługują tylko en.

Naprawy związane z tłumaczeniem i walidacją JSON¶

Przebieg tłumaczenia został wzmocniony przed wdrożeniem endpointów:

• Ochronione miejsca zastępcze, URL-e, punkty końcowe, nazwy plików, adresy e-mail i tokeny API są zachowane
• Duże ciągi JSON są bezpiecznie dzielone na fragmenty
• Dokładne pozostałości w języku angielskim są oznaczane podczas testów jakościowych
• Struktura JSON po tłumaczeniu jest porównywana ze strukturą źródłową w języku angielskim
• Atomowe zapisywanie zapobiega częściowym zapisom JSON
• Logika kontynuacji pomija tylko strukturalnie poprawne pliki przetłumaczone

Nowy pakiet znaczeń endpointów został zweryfikowany przed skopiowaniem do folderów z językami.

Naprawy dokumentacyjne¶

Dokumentacja została dopasowana do wdrożonej powierzchni API:

• Dodano num_sys do odpowiednich przykładów GET i POST.
• Zdokumentowano obsługę 8 języków dla nowych stron.
• Dodano 10 nowych stron do indeksu Extended Endpoints.
• Normalizowano tabele parametrów Markdown, aby prawidłowo wyświetlały się typy nullable.

Naprawy walidacyjne w produkcjiPonowna walidacja została przeprowadzona przy użyciu standardowego środowiska Python:¶

• Python: /opt/homebrew/bin/python3.11
• Pełne testy: 137 passed
• Sprawdzenie OpenAPI: obecność czystych tras
• Ukryte/proponowane trasy /extended dla nowych punktów końcowych: brak

Przestarzałe¶

Żaden istniejący punkt końcowy produkcyjny nie jest formalnie oznaczony jako przestarzały w wersji 1.0.1.

Notatka dotycząca niepublicznej trasy w wersji roboczej¶

Kształt trasy /api/v1/extended/* dla 10 nowych rodzin punktów końcowych nie jest częścią publicznego interfejsu API w wersji 1.0.1.

Użyj czystych tras zamiast:

• /api/v1/career-path-numerology
• /api/v1/wealth-code-reading
• /api/v1/home-address-numerology
• /api/v1/baby-name-forecast
• /api/v1/team-dynamics-numerology
• /api/v1/domain-name-numerology
• /api/v1/product-name-numerology
• /api/v1/decision-crossroads-reading
• /api/v1/launch-timing-numerology
• /api/v1/personal-archetype-stack

Panel kontrolny

Powiązane dokumenty¶

• Zintegrowany changelog wersji 1.0.0