Versionado

AstroWay API utiliza versionado por URL: la versión está especificada en la ruta de la solicitud. Es más simple que el versionado por encabezados y se cachea bien por los proxies.

https://api.astroway.info/v1/chart

SemVer para API

Nos adherimos a la semántica de semver.org:

• MAJOR (v1 → v2): cambios importantes. La versión anterior continúa funcionando al menos 12 meses después del lanzamiento de la nueva.
• MINOR: nuevos endpoints, nuevos campos opcionales. Totalmente compatible.
• PATCH: correcciones de errores, refinamientos de precisión. Visible en el encabezado de respuesta X-Api-Version: 1.12.3.

Qué NO se considera cambio importante

• Agregar un nuevo endpoint
• Agregar un nuevo campo opcional al cuerpo de la solicitud
• Agregar un nuevo campo a la respuesta
• Refinar el texto de los mensajes de error (los códigos code permanecen estables)
• Cambios en la precisión de los cálculos dentro de los declarados ±1” (planetas) / ±1’ (casas)
• Aumentar el límite de tasa o presupuesto de crédito en tu plan

Esto significa: tu código no debe fallar al agregar un nuevo campo a la respuesta. Analiza solo lo que necesitas, ignora el resto.

Qué SÍ es cambio importante (solo en lanzamientos mayores)

• Eliminar o renombrar un endpoint
• Eliminar o renombrar un campo en la respuesta
• Cambiar el tipo de campo (por ejemplo, number → string)
• Cambiar la semántica del campo (qué significa el mismo nombre)
• Cambiar code en la respuesta de error
• Endurecer la validación que podría romper solicitudes previamente válidas

Registro de cambios

Todos los cambios están en Changelog. Lanzamientos menores cada 2-4 semanas, correcciones según estén listas.

Suscríbete a las actualizaciones:

• RSS: https://api.astroway.info/changelog/rss.xml
• Email: Configuración → Notificaciones → Actualizaciones del producto en el dashboard

Política de obsolescencia

Cuando un campo o endpoint se vuelve obsoleto:

1. Se anuncia en el registro de cambios + aviso por correo electrónico
2. Aparece el encabezado de respuesta: Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (estándar RFC 8594)
3. La API obsoleta continúa funcionando al menos 12 meses
4. Eliminación: solo en el próximo lanzamiento mayor