...
| Note |
|---|
AVISO: El nuevo valor reemplazará al antiguo, por lo que cualquier sistema externo que utilice los WS API debe iniciarse utilizando el nuevo token. |
Versión del API
La versión actual del API proporcionada por central es la v2, que usa el nuevo sistema de versionado.
Urls
Desde la versión 6.6 de la plataforma, se produce un cambio en el sistema de versionado del API, dejando como obsoleto el versionado por url y pasando a usar el sistema recomendado de versionado mediante cabeceras Accept.
Es decir, las urls tipo "/admin/rest/administration/v1/<recurso>..." pasan a estar obsoletas (sin embargo, seguirán funcionando como hasta ahora).
Las nuevas urls serán del tipo "/admin/rest/administration/api/<recurso>..." y se usará una versión u otra según el valor enviado en la cabecera Accept
Formato cabecera Accept
El formato de la cabecera para indicar una versión en concreto será "application/vnd.netex.nlc-api{.vX}+{type}"
Donde:
- .vX: indicará una versión en concreto. Ejemplo ".v1". Si no se indica se usará la última
- type: indicará el tipo de retorno (json, xml, plain,..)
Examples:
| Accept (JSON) | Accept (Plain) | Versión |
|---|---|---|
| Usará la última versión disponible del servicio web | ||
*/* | */* | Usará la última versión disponible del servicio web |
application/json | text/plain | Usará la última versión disponible del servicio web |
application/vnd.netex.nlc-api+json | application/vnd.netex.nlc-api+plain | Usará la última versión disponible del servicio web |
application/vnd.netex.nlc-api.v1+json | application/vnd.netex.nlc-api.v1+plain | Usará la versión 1 del API (la misma que con la url antigua) |
application/vnd.netex.nlc-api.v2+json | application/vnd.netex.nlc-api.v2+plain | Usará la versión 2 del API (si el servicio web en concreto no tiene una nueva versión se usará la versión anterior) |