Skip to main content

​
URL base, versiones y estructura de endpoints

Sorsa API incluye la versión en la URL para mantener estables tus integraciones. Cada solicitud indica explícitamente la versión de la API a la que se dirige.

​
URL base

Todas las solicitudes se realizan mediante HTTPS. Las solicitudes HTTP sin cifrar no se admiten y se rechazan.
La ruta de cada endpoint es relativa a esta URL base. Por ejemplo, la URL completa para consultar un perfil de usuario es:

​
Versión actual: v3

v3 es la versión actual, estable y recomendada de Sorsa API. Los nuevos endpoints, campos de respuesta y mejoras se incorporan a v3.

​
Cómo gestionamos los cambios de versión

No todas las actualizaciones requieren un nuevo número de versión. Los cambios se dividen en dos categorías.

​
Cambios compatibles (dentro de v3)

Se añaden a la versión actual sin cambiar su número. Tus integraciones siguen funcionando sin que tengas que modificarlas:
  • Nuevos endpoints.
  • Nuevos parámetros de consulta opcionales en endpoints existentes.
  • Nuevos campos en los objetos JSON de respuesta.
  • Mejoras en los mensajes de error o información adicional en las respuestas de error.
Como pueden añadirse campos en cualquier momento, procesa las respuestas de forma tolerante: lee los campos que necesitas e ignora las claves desconocidas, en lugar de fallar cuando aparezca un campo inesperado.

​
Cambios incompatibles (nueva versión)

Si necesitamos eliminar campos de respuesta, cambiar nombres de parámetros, modificar la autenticación o alterar el comportamiento esencial de un endpoint, publicaremos una nueva versión (por ejemplo, /v4). En ese caso:
  • La versión anterior seguirá disponible durante un periodo de retirada anunciado con claridad.
  • Publicaremos por adelantado una guía de migración con equivalencias de campos y cambios estructurales.
  • Comunicaremos los plazos de retirada en el panel y en la documentación.

​
Versión anterior: v2 (retirada)

La versión v2 está obsoleta y ya no está disponible. Su cierre estaba previsto para el 1 de mayo de 2026 y sus endpoints ahora devuelven 410 Gone. Si tienes una integración con Sorsa v2, consulta los esquemas de solicitudes y respuestas de v3 en la referencia de la API y contacta con soporte para obtener ayuda. La guía de migración desde la API oficial de X trata una API de origen diferente.

​
Próximos pasos