> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# URL base y versiones

# 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.

```text theme={null}
https://api.sorsa.io/v3
```

La ruta de cada endpoint es relativa a esta URL base. Por ejemplo, la URL completa para consultar un perfil de usuario es:

```text theme={null}
https://api.sorsa.io/v3/info?username=elonmusk
```

## 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](https://docs.sorsa.io/es/api-reference-guide) y [contacta con soporte](https://docs.sorsa.io/es/support) para obtener ayuda. La guía de migración desde la API oficial de X trata una API de origen diferente.

## Próximos pasos

* [Autenticación](https://docs.sorsa.io/es/authentication): cómo autorizar solicitudes a v3.
* [Soporte](https://docs.sorsa.io/es/support): ayuda para migrar una integración existente con Sorsa v2.
* [Referencia de la API](https://docs.sorsa.io/es/api-reference-guide): endpoints, parámetros y esquemas de respuesta.