Versión actual
La API usa versionado en la URL:/api/v1/.
Política de cambios
| Tipo de cambio | Qué hacemos |
|---|---|
| Nuevo endpoint | Se agrega bajo /api/v1/ sin aviso previo requerido |
| Nuevo campo en response | Se agrega bajo /api/v1/ — backwards compatible |
| Campo nuevo requerido en request | Se anuncia con anticipación, luego /api/v2/ |
| Cambio en comportamiento existente | Se anuncia con anticipación, luego /api/v2/ |
| Eliminación de campo o endpoint | Se depreca primero, luego /api/v2/ |
Los cambios breaking se anuncian por email a todos los titulares de API Key con al menos 60 días de anticipación antes de introducir una nueva versión.
Múltiples versiones activas
Cuando exista/api/v2/, la versión /api/v1/ permanecerá activa durante un período de transición mínimo de 6 meses para permitir la migración sin interrupciones.