Registro de cambios Numerology API v1.0.1¶

Fecha de lanzamiento: 2026-06-08
Versión: v1.0.1
Alcance: Expansión de endpoints de la API Numerology, soporte de numerología multi-sistema, localización extendida de significados JSON, limpieza de rutas y paridad de documentación.

Resumen general de la versión¶

v1.0.1 es una versión aditiva de producción para la API Numerology. Se basa en el rollout de numerología extendida v1.0.0 añadiendo lecturas más profundas sobre nombre, timing, negocios, decisiones, familia, equipo, dinero y arquetipos.

Esta versión se centra en cuatro objetivos principales:

1. Cobertura más amplia de endpoints
2. Añade 10 nuevas familias de endpoints.
3. Cada nuevo endpoint soporta tanto GET como POST.

4. Todos los nuevos endpoints usan rutas públicas limpias bajo /api/v1/*.

5. Numerología multi-sistema

6. Los nuevos endpoints basados en nombre soportan el parámetro opcional num_sys.
7. Sistemas soportados:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean permanece como predeterminado para preservar el comportamiento existente.

9. Cobertura lingüística ampliada

10. Los idiomas de respuesta soportados ahora incluyen:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. Las 10 nuevas familias de endpoints incluyen archivos JSON de significados localizados para los 8 idiomas soportados.

12. Documentación y preparación para el lanzamiento

13. Añade documentación de integración para las 10 nuevas familias de endpoints.
14. Actualiza el índice de Extended Endpoints.
15. Documenta el comportamiento de GET, POST, lang y num_sys.
16. Verifica visibilidad de rutas, cobertura JSON y estabilidad de la suite de tests con Python 3.11.

Validación completada para esta versión:

• Suite completa de tests Python: 137 passed
• Comprobación de rutas OpenAPI: las 10 rutas limpias presentes
• Nuevas rutas /api/v1/extended/*: no montadas
• Validación de traducciones JSON: 8 carpetas de idiomas, 444 archivos cada una, sin discrepancias de estructura
• Archivos JSON copiados en vivo: 8 idiomas × 444 archivos cada

Novedades¶

Nuevas familias de endpoints¶

v1.0.1 añade 10 nuevas familias de endpoints y 20 operaciones.

Nueva infraestructura compartida de endpoints¶

v1.0.1 añade lógica de ayuda compartida para los nuevos endpoints de numerología extendida, incluyendo:

• Carga de JSON localizados
• Búsqueda de configuración de endpoints
• Búsqueda de significados y significados detallados
• Cálculo de perfil de nombre
• Ayudantes de numerología de fecha de nacimiento
• Ayudantes de puntuación
• Seguimiento de uso
• Envoltura de respuesta empresarial
• Reutilización de autorización de solicitudes

Endurecimiento del sistema de numerología¶

El ayudante compartido numerology-system ahora incluye tablas de letras explícitas y validadas para todos los sistemas soportados:

• pythagorean
• chaldean
• vedic

La tabla védica es compatible con nombres transliterados al latín y se mantiene separada de la caldea aunque ambos sistemas usan los mismos valores A-Z en v1.0.1. Los diacríticos latinos comunes y ligaduras se normalizan antes del cálculo del nombre, y los ayudantes de valores de nombre faltantes ahora respetan el rango real del alfabeto de cada sistema.

Nueva cobertura de tests¶

Los nuevos tests cubren:

• Comportamiento del calculador para las 10 familias de endpoints
• Soporte de sistemas de numerología chaldean y vedic
• Soporte de política de 8 idiomas
• Búsqueda de significados localizados
• Visibilidad de rutas OpenAPI
• Forma canónica de rutas sin /extended

Correcciones¶

Limpieza de rutas¶

Las nuevas familias de endpoints ahora usan solo rutas públicas limpias:

• Correcto: /api/v1/career-path-numerology
• Correcto: /api/v1/wealth-code-reading
• Correcto: /api/v1/personal-archetype-stack

La forma de ruta borrador /api/v1/extended/* para estas 10 nuevas familias no está montada y no aparece en OpenAPI.

Correcciones de política de idioma¶

La política de idioma compartida ahora incluye los 8 idiomas soportados:

• en
• es
• de
• fr
• pt
• ar
• hi
• ja

La excepción existente para los informes de horóscopo permanece sin cambios: las rutas /api/v1/horoscope/reports/* respaldadas por motor continúan soportando solo en.

Correcciones de traducción y validación JSON¶

El flujo de trabajo de traducción se endureció antes del rollout de endpoints:

• Se preservan placeholders protegidos, URLs, endpoints, nombres de archivos, emails y tokens API
• Las cadenas JSON grandes se fragmentan de forma segura
• Se marcan residuos exactos en inglés durante QA
• La estructura JSON traducida se compara con la estructura fuente en inglés
• La escritura atómica evita escrituras JSON parciales
• La lógica de reanudación omite solo archivos traducidos estructuralmente válidos

El nuevo paquete de significados de endpoints se validó antes de copiarlo en las carpetas de idiomas en vivo.

Correcciones de documentación¶

La documentación se alineó con la superficie API implementada:

• Se añadió num_sys a los ejemplos GET y POST relevantes.
• Se documentó el soporte de 8 idiomas para las nuevas páginas.
• Se añadieron las 10 nuevas páginas al índice de Extended Endpoints.
• Se normalizaron las tablas de parámetros Markdown para que los tipos nullable se rendericen correctamente.

Correcciones de validación en producción¶

Se volvió a ejecutar la validación usando el estándar Python del workspace:

• Python: /opt/homebrew/bin/python3.11
• Tests completos: 137 passed
• Comprobación OpenAPI: rutas limpias presentes
• Rutas ocultas/borrador /extended para los nuevos endpoints: ausentes

Obsoletos¶

Ningún endpoint de producción existente está formalmente deprecado en v1.0.1.

Nota sobre rutas borrador no públicas¶

La forma de ruta borrador /api/v1/extended/* para las 10 nuevas familias de endpoints no forma parte de la superficie pública de la API v1.0.1.

Use las rutas limpias en su lugar:

• /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

Abrir Dashboard

Documentos relacionados¶

• Registro unificado v1.0.0