Versiones actuales
| Versión | Estado | Descripción |
|---|---|---|
| v2 | Vigente | Endpoints modernos, precios flexibles, todas las nuevas funciones |
| v1.1 | Heredada | Soporte limitado, actualizaciones mínimas |
| Enterprise | Disponible | Acceso de alto volumen con soporte dedicado |
Versión en las URL
Cambios incompatibles vs. compatibles
Cambios incompatibles con versiones anteriores (requieren actualizaciones de código)
- Eliminar un endpoint
- Eliminar un campo de la respuesta
- Eliminar un parámetro de consulta
- Agregar un nuevo parámetro obligatorio
- Cambiar el tipo de datos de un campo
- Cambiar el nombre de un campo o recurso
- Cambiar códigos de respuesta o tipos de error
- Modificar scopes de autorización
Cambios retrocompatibles (aditivos)
- Agregar un nuevo endpoint
- Agregar un nuevo parámetro opcional
- Agregar un nuevo campo de respuesta
- Agregar nuevos scopes de OAuth
- Cambiar el texto del mensaje de error
- Establecer campos como null por razones de privacidad o seguridad
Calendario de lanzamientos
| Tipo | Frecuencia | Aviso previo |
|---|---|---|
| Versiones principales | No más de una vez al año | Se proporcionan guías de migración |
| Cambios compatibles | De forma continua | Actualizaciones del registro de cambios (changelog) |
| Parches de seguridad | Según sea necesario | Pueden aplicarse a la versión actual |
Política de obsolescencia
- Obsolescencia: La versión anterior se marca como obsoleta
- Periodo de soporte: La versión obsoleta continúa funcionando durante un periodo definido
- Retirada: La versión obsoleta se elimina
Definiciones
| Estado | Significado |
|---|---|
| Activo | Con soporte completo, con nuevas funciones y correcciones |
| Obsoleto | Sin nuevas funciones; solo errores críticos; se desaconseja su uso |
| Retirado | Ya no disponible |
Mantenerse informado
Registro de cambios
Todos los cambios y actualizaciones de la plataforma.
Anuncios del foro
Avisos de cambios incompatibles.
@XDevelopers
Noticias y actualizaciones de la plataforma.
Boletín
Resumen mensual.
Recursos de migración
- Guías de migración: instrucciones de actualización paso a paso
- Asignación de endpoints: equivalencias de v1 a v2
- Cambios en el formato de datos: diferencias en el modelo de objetos
Resumen de la migración
Recomendaciones actuales para la migración.
Mapa de endpoints
Asignación de endpoints de v1 a v2.
Mejores prácticas
Usa v2
Inicia los nuevos proyectos en la versión más reciente.
Sigue los anuncios
Suscríbete al registro de cambios y a las actualizaciones del foro.
Prueba los cambios
Prueba los cambios en desarrollo antes de aplicarlos en producción.
Planifica las migraciones
No esperes a que se declare obsoleta para actualizar.