Identification API

Permet de générer, renouveler et supprimer une clé d'accès à l'API.

Générer une clé API

POST /v1/login

Authentifie l'utilisateur et retourne un token d'accès ainsi qu'un refresh token.

Body (JSON)

Nom	Type	Requis	Description
username	String	oui	Nom d'utilisateur
password	String	oui	Mot de passe

Réponses

200 — Authentification réussie

{
    "success": true,
    "code": "200",
    "message": "OK",
    "parameters": {},
    "result": {
        "token": "string",
        "tokenExpirationDate": "datetime",
        "refreshToken": "string",
        "refreshTokenExpirationDate": "datetime"
    }
}

400 — Bad Request

{
    "success": false,
    "code": "400",
    "message": "Les paramètres username et password sont requis"
}

401 — Unauthorized

{
    "success": false,
    "code": "401",
    "message": "Identifiants incorrects"
}

403 — Forbidden

{
    "success": false,
    "code": "403",
    "message": "Utilisateur non autorisé"
}

---

Renouveler une clé API

POST /v1/refreshToken

Renouvelle le token d'accès à partir d'un refresh token valide.

Body (JSON)

Nom	Type	Requis	Description
refreshToken	String	oui	Refresh token obtenu lors du login

Réponses

200 — Token renouvelé

{
    "success": true,
    "code": "200",
    "message": "OK",
    "parameters": {},
    "result": {
        "token": "string",
        "tokenExpirationDate": "datetime",
        "refreshToken": "string",
        "refreshTokenExpirationDate": "datetime"
    }
}

400 — Bad Request

{
    "success": false,
    "code": "400",
    "message": "Le paramètre refreshToken est requis"
}

401 — Unauthorized

{
    "success": false,
    "code": "401",
    "message": "Refresh token invalide ou expiré"
}

403 — Forbidden

{
    "success": false,
    "code": "403",
    "message": "Utilisateur non autorisé"
}

---

Supprimer une clé API

POST /v1/logout

Invalide le token d'accès courant.

Headers

Nom	Type	Requis	Description
x-access-token	String	oui	Clé API

Réponses

200 — Déconnexion réussie

{
    "success": true,
    "code": "200",
    "message": "OK",
    "parameters": {}
}

401 — Unauthorized

{
    "success": false,
    "code": "401",
    "message": "Clé API invalide"
}