Authenticating a request
...
Autenticar una solicitud
- Los WS API deben estar activados para poder acceder a ellos.
- Los protocolos disponibles son HTTP y HTTPS. Si es posible, se recomienda emplear el HTTPS.
- Cada solicitud debe incluir la siguiente cabecera:
Nombre de cabecera: X-Auth-TokenValueValor: Valor token value (exampleejemplo: a08443af-cc58-4e3e-b557-13be8de66230)
- No other type of authentication is done fo access to the se puede realizar ningún otro tipo de autenticación para acceder a los WS API.
How to find token value
...
Encontrar el valor token
Se puede encontrar este valor en la página http://[learningcentral_customer_domain]/admin/clientauthtoken
You just need to log in learningCentral with administrator user role
Generating new token
This value can be generated here Tan solo necesita iniciar la sesión en learningCentral con el rol de usuario soporte.
Generar un nuevo token
Este valor puede generarse aquí http://[learningcentral_customer_domain]/admin/clientauthtoken
You just need to log in learningCentral with administrator user roleTan solo necesita iniciar la sesión en learningCentral con el rol de usuario soporte.
...
| Note |
|---|
WARNING: The new value will replace the old one. So any external system which is using the WS API must start using the new token |
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) |