Utilisez cet endpoint pour générer un token d'accès IDMobile. Ce token est nécessaire pour appeler tous les autres endpoints de scope IDMobile.
Documentation ID Mobile associée :
Requête GET
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret={CLIENT_SECRET}&grant_type=client_idmobile&licence={LICENCE_CODE}Remplacez les valeurs entre accolades par vos propres informations :
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| SERVER_ADDRESS | Adresse du serveur DQE qui traitera les données. | Obligatoire |
| licence | Numéro qui vous a été attribué comme code de licence. | Obligatoire |
| client_secret | Phrase secrète fournie par le client. | Obligatoire |
| grant_type | Valeur statique. Doit être client_idmobile. |
Obligatoire |
Requête POST
https://{SERVER_ADDRESS}/ACCESS_TOKEN/Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded :
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| licence | Numéro qui vous a été attribué comme code de licence. | Obligatoire |
| client_secret | Phrase secrète fournie par le client. | Obligatoire |
| grant_type | Valeur statique. Doit être client_idmobile. |
Obligatoire |
Réponse
Succès
L'API renvoie un objet JSON contenant les clés suivantes :
| Clé | Description | Type |
|---|---|---|
| access_token | Token temporaire utilisé pour appeler les services IDMobile. | STRING |
| token_type |
Bearer : le type de token autorisé. |
STRING |
| expires_in | Durée de validité du token, en secondes. | STRING |
| refresh_token | Token utilisé pour prolonger votre session. | STRING |
Exemple :
{
"access_token": "TK948869a6f873adb622enhoaGeVY2iRaptqlmpplGeWZA",
"token_type": "Bearer",
"expires_in": "300",
"refresh_token": "*TK9bdd05f8e9d3c905834bdeqaUlGFll2iRaplll29mZmtkZQ"
}Erreur
| Type d'erreur | Exemple de requête | Réponse |
|---|---|---|
Paramètre licence manquant |
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile |
Erreur 400 (Requête invalide) |
Paramètre licence vide |
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence= |
Erreur 400 (Requête invalide) |
Valeur licence incorrecte |
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&grant_type=client_idmobile&licence={INCORRECT_LICENCE_CODE} |
Erreur 400 (Client invalide) |
client_secret manquant ou vide
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?grant_type=client_idmobile&licence={LICENCE_CODE} |
Erreur 400 (Requête invalide) |
grant_type manquant ou incorrect
|
https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_secret=abcd&licence={LICENCE_CODE} |
Erreur 400 (Requête invalide) |
| Faute de frappe dans un paramètre | https://{SERVER_ADDRESS}/ACCESS_TOKEN/?client_scret=abcd&grant_type=client_idmobile&licence={LICENCE_CODE} |
Erreur 500 |