Utilice este endpoint para generar un token de acceso IDMobile. El token es necesario para llamar a todos los demás endpoints del scope IDMobile.
Documentación relacionada de ID Mobile:
Solicitud GET
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret={CLIENT_SECRET}&grant_type=client_idmobile&licence={LICENCE_CODE}Reemplace los valores entre llaves con su propia información:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor DQE que procesará los datos. | Obligatorio |
| licence | Número asignado como su código de licencia. | Obligatorio |
| client_secret | Frase de contraseña proporcionada por el cliente. | Obligatorio |
| grant_type | Valor estático. Debe ser client_idmobile. |
Obligatorio |
Solicitud POST
https://{SERVER_ADDRESS}/ACCESS_TOKEN/Añada los parámetros siguientes en el cuerpo de la solicitud usando x-www-form-urlencoded:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| licence | Número asignado como su código de licencia. | Obligatorio |
| client_secret | Frase de contraseña proporcionada por el cliente. | Obligatorio |
| grant_type | Valor estático. Debe ser client_idmobile. |
Obligatorio |
Respuesta
Éxito
La API devuelve un objeto JSON que contiene las siguientes claves:
| Clave | Descripción | Tipo |
|---|---|---|
| access_token | Token temporal utilizado para llamar a los servicios IDMobile. | STRING |
| token_type |
Bearer: el tipo de token autorizado. |
STRING |
| expires_in | Período de validez del token, en segundos. | STRING |
| refresh_token | Token utilizado para prolongar su sesión. | STRING |
Ejemplo:
{
"access_token": "TK948869a6f873adb622enhoaGeVY2iRaptqlmpplGeWZA",
"token_type": "Bearer",
"expires_in": "300",
"refresh_token": "*TK9bdd05f8e9d3c905834bdeqaUlGFll2iRaplll29mZmtkZQ"
}Error
| Tipo de error | Ejemplo de solicitud | Respuesta |
|---|---|---|
Falta el parámetro licence
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile |
400 Error (Invalid Request) |
Parámetro licence vacío |
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence= |
400 Error (Invalid Request) |
Valor de licence incorrecto |
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence={INCORRECT_LICENCE_CODE} |
400 Error (Invalid Client) |
Falta o está vacío client_secret
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?grant_type=client_idmobile&licence={LICENCE_CODE} |
400 Error (Invalid Request) |
Falta o es incorrecto grant_type
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&licence={LICENCE_CODE} |
400 Error (Invalid Request) |
| Error tipográfico en un parámetro | https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_scret=abcd&grant_type=client_idmobile&licence={LICENCE_CODE} |
500 Error |