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 (email)
password	String	oui	Mot de passe

Réponses

200 — Authentification réussie

{
    "success": true,
    "token": "string",
    "tokenExpirationDate": "datetime",
    "refreshToken": "string",
    "refreshTokenExpirationDate": "datetime",
    "message": "string"
}

Notes :

• Les champs sont retournés à la racine de la réponse (il n'y a pas d'objet result ni de champ code sur cette route).
• message est un texte informatif sur les rappels d'expiration du refresh token (envoyés par email), pas un simple "OK".

400 — Bad Request

{
    "success": false,
    "message": "username et password nécessaire",
    "parameters": {}
}

401 — Unauthorized

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

403 — Forbidden

{
    "success": false,
    "message": "Accès interdit"
}

Retourné si l'utilisateur est inactif, n'a pas de type de compte, ou si l'abonnement n'autorise pas de nouvel utilisateur.

---

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,
    "token": "string",
    "tokenExpirationDate": "datetime",
    "refreshToken": "string",
    "refreshTokenExpirationDate": "datetime"
}

Notes :

• Les champs sont retournés à la racine de la réponse (pas d'objet result, pas de champ code).
• Le refreshToken renvoyé est inchangé ; seul le token (et sa date d'expiration) est régénéré.

400 — Bad Request

{
    "success": false,
    "parameters": { "refreshToken": "string|null" },
    "message": "refreshToken nécessaire"
}

401 — Unauthorized

{
    "success": false,
    "parameters": { "refreshToken": "string" },
    "message": "refreshToken invalide"
}

403 — Forbidden

{
    "success": false,
    "parameters": { "refreshToken": "string" },
    "message": "Accès interdit"
}

---

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,
    "parameters": { "token": "string" },
    "message": "token supprimé"
}

Note : cette route ne renvoie pas de champ code, et parameters contient le token fourni.

400 — Bad Request

{
    "success": false,
    "parameters": { "token": null },
    "message": "token nécessaire"
}

401 — Unauthorized

{
    "success": false,
    "parameters": { "token": "string" },
    "message": "token invalide"
}