Autorisation (Authorization)
Type de Token
Nos points d'entrée utilisent un Bearer Token afin de pouvoir s'authentifier.
Le Bearer Token est à renseigner dans l'entête des points d'entrée.
Exemple : Authorization: Bearer 94db1a68722e4eeb82d57eae86786451
Obtention du Bearer Token
Le point d'entrée Token permet de récupérer les informations du Bearer Token.
Deux informations sont à fournir à l'entête (Header) lors de l'appel afin d'obtenir les informations du Token :
- Identifiant (Chaîne hexadécimale d'une longueur de 32)
- MotDePasse (Chaîne hexadécimale d'une longueur de 32)
Le point d'entrée va retourner un JSON contenant les informations du Token :
Nom de la rubrique |
Type de rubrique |
Lecture seule |
Obligatoire |
Détail |
TokenID |
Chaîne(32) |
|
|
Correspond au Token à utiliser dans les points d'entrée. |
TokenID_Date |
Date |
|
|
Date de fin de validité du Token |
TokenID_Heure |
Date |
|
|
Heure de fin de validité du Token |
Exemple :
{
"TokenID": "94db1a68722e4eeb82d57eae86786451",
"TokenID_Date": "2042-01-13",
"TokenID_Heure": "16:14:13.000"
}
Détail du point d'entrée
Nom du point d'entrée |
Token |
Chemin |
Token |
Accessible en GET |
|
Accessible en POST |
|
Accessible en PATCH |
|
Accessible en DEL |
|
Le point d'entrée Token est le seul point d'entrée qui ne nécessite pas de "Authorization" au niveau de l'entête (Header).
Tous les autres point d'entrée doivent avoir cette information renseignée afin de pouvoir être consommés.
Vérification du Token
Le point d'entrée [GET] StatutToken permet de connaître la validité d'un Token.
Ce point d'entrée nécessite la transmission du Bearer Token
Aucun paramètre au body est nécessaire.
Le point d'entrée va retourner un JSON contenant le statut du Token :
Nom de la rubrique |
Type de rubrique |
Lecture seule |
Obligatoire |
Détail |
Token_Statut |
Chaîne(10) |
|
|
Statut du Token : - Valide - Invalide (Date ou heure de fin de validité dépassée) - Inconnu (Token ne correspond pas au compte) |
Token_Date |
Date |
|
|
Date de fin de validité du Token |
Token_Heure |
Date |
|
|
Heure de fin de validité du Token |
Exemple :
{
"Token_Statut": "Valide",
"Token_Date": "2042-01-13",
"Token_Heure": "16:14:13.000"
}