Passer au contenu principal
POST
L’authentification est une nouveauté. Ces endpoints sont servis par l’émetteur de votre application, par exemple https://<name>.auth.didit.me, et n’acceptent jamais votre clé API Didit.
Un token d’actualisation n’est utilisable qu’une seule fois. Renvoyer un token d’actualisation déjà utilisé révoque l’intégralité de la session. Exécutez donc une seule actualisation à la fois pour une session, et remplacez les trois tokens ensemble. Voir Jetons d’actualisation.

Corps

L'un des deux grants, choisi par grant_type. L'endpoint accepte les champs des deux grants et valide chaque champ qu'il reçoit, de sorte qu'un rafraîchissement transmettant également un code_verifier malformé reçoit une erreur de champ. Envoyez uniquement les champs correspondant à votre grant ; tout autre champ reçoit unknown_field.

​
grant_type
enum<string>
requis
Options disponibles:
authorization_code
​
code
string
requis

Le paramètre de requête code reçu par votre redirect_uri. Vérifiez le state du rappel avant de l'échanger.

Maximum string length: 128
Exemple:

"Vb0bVt4CLlr8ZL0kE5mAxv8gS6R0rW3hYqC1pN7dJ2s"

​
code_verifier
string
requis

Le vérificateur PKCE dont le hachage S256 correspondait au code_challenge de la connexion.

Required string length: 43 - 128
Pattern: ^[A-Za-z0-9._~-]{43,128}$
Exemple:

"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"

​
redirect_uri
string
requis

L'URI redirect_uri exacte avec laquelle la connexion a débuté. Elle doit toujours faire partie des URI de redirection de l'application.

Maximum string length: 2048
Exemple:

"https://app.example.com/auth/callback"

​
client_id
string

Facultatif. Lorsqu'il est envoyé, il doit être égal à votre ID d'application, sinon la requête échoue avec invalid_client.

Maximum string length: 64
Exemple:

"7b0a6c2e-3f41-4c9a-8d55-1e2f3a4b5c6d"

​
scope
string

Optionnel et accepté depuis les clients OpenID Connect standard. Il n'élargit jamais ce que l'authentification a accordé.

Maximum string length: 512
Exemple:

"openid email"

Réponse

Nouveaux tokens pour la session.

Tokens pour une session. Remplacez les trois ensemble après une actualisation.

​
access_token
string
requis

JWT ES256, en-tête typ: at+jwt. Envoyez-le sous la forme Authorization: Bearer <access_token>. Revendications : AccessTokenClaims.

Exemple:

"eyJhbGciOiJFUzI1NiIsImtpZCI6ImtfOHNKMmRRdlgwbkxyNVRmWWIzSGtQdyIsInR5cCI6ImF0K2p3dCJ9.eyJpc3MiOiJodHRwczovL3lvdXItYXBwLmF1dGguZGlkaXQubWUiLCJhdWQiOiI3YjBhNmMyZS0zZjQxLTRjOWEtOGQ1NS0xZTJmM2E0YjVjNmQiLCJzdWIiOiIxYzlkOGI4OC0xYmZmLTQzZDEtYWQ3YS04OGIyYmMwMDI0ZTkiLCJzaWQiOiJjOWFiZjZjYy0yZDY0LTRiZjItYjMxZS1hNGQwOWEwNzBhYjEiLCJqdGkiOiJSZ3F1NzE3OWUtbGhKMGJ2VmVELVlnIiwiaWF0IjoxNzkyMjMzNjc0LCJleHAiOjE3OTIyMzM5NzQsInZlbmRvcl9kYXRhIjoidXNlci00MiIsIm9yZyI6bnVsbCwidmVyaWZpZWQiOnt9LCJhbXIiOlsicGFzc3dvcmQiXSwiYWN0IjpudWxsLCJjbGllbnRfaWQiOiI3YjBhNmMyZS0zZjQxLTRjOWEtOGQ1NS0xZTJmM2E0YjVjNmQifQ.AxrqN8Pm-Op-3OayZk8HcvlFQZhozRiOvQ0SgQsGgrz4UNeJlUEeSlq9B8WcYUuM8naRaY5kQt_TUofnsYcyYQ"

​
id_token
string
requis

JWT ES256, en-tête typ: JWT, permettant à votre application d'identifier qui s'est connecté. Ne l'envoyez jamais comme token d'accès. Revendications : IDTokenClaims.

Exemple:

"eyJhbGciOiJFUzI1NiIsImtpZCI6ImtfOHNKMmRRdlgwbkxyNVRmWWIzSGtQdyIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL3lvdXItYXBwLmF1dGguZGlkaXQubWUiLCJhdWQiOiI3YjBhNmMyZS0zZjQxLTRjOWEtOGQ1NS0xZTJmM2E0YjVjNmQiLCJzdWIiOiIxYzlkOGI4OC0xYmZmLTQzZDEtYWQ3YS04OGIyYmMwMDI0ZTkiLCJzaWQiOiJjOWFiZjZjYy0yZDY0LTRiZjItYjMxZS1hNGQwOWEwNzBhYjEiLCJqdGkiOiJNTHRPNHM4SHItQnJrcDd2NTlPV0Z3IiwiaWF0IjoxNzkyMjMzNjc0LCJleHAiOjE3OTIyMzM5NzQsInZlbmRvcl9kYXRhIjoidXNlci00MiIsIm9yZyI6bnVsbCwidmVyaWZpZWQiOnt9LCJhbXIiOlsicGFzc3dvcmQiXSwiYWN0IjpudWxsLCJhdXRoX3RpbWUiOjE3OTIyMzM2NzQsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJlbWFpbCI6InBlcnNvbkBleGFtcGxlLmNvbSIsIm5vbmNlIjoibi0wUzZfV3pBMk1qIn0.avhfDFp_aUV5_1ssYzwDcIA7H6Waf19P0bn5GCg25FhLIZBGIlwc8HiUPGj1j26r21OkP4FQnS_jM1Ho3dHtKQ"

​
refresh_token
string
requis

À usage unique. Valide jusqu'à la fin de la session, chaque rafraîchissement en renvoie un nouveau.

Exemple:

"N4yZTl6y24YKYq77X_SOrBn1q2Lit81WBQMOay7dq_IVfTnxyY8ZGcJk-6-fcmWW"

​
token_type
enum<string>
requis
Options disponibles:
Bearer
​
expires_in
integer
requis

Secondes avant que le token d'accès n'expire : au maximum 300, moins si la session se termine plus tôt.

Plage requise: 0 <= x <= 300
Exemple:

299

​
session_id
string<uuid>
requis

La session à laquelle appartiennent ces tokens, qui a la même valeur que la revendication sid.

Exemple:

"c9abf6cc-2d64-4bf2-b31e-a4d09a070ab1"

Dernière modification le 7 novembre 2026