Référence API

Authentification

Points de terminaison pour la connexion, l'inscription et la gestion des jetons d'authentification. Tous les points de terminaison sont préfixés par /v1.

URL de base

text

https://api.authon.dev

Autorisation

bash

# Client requests — use publishable key
Authorization: Bearer pk_live_your_publishable_key

# Server requests — use secret key
Authorization: Bearer sk_live_your_secret_key

POST/v1/auth/signin

Connexion par e-mail

Authentifiez un utilisateur avec un e-mail et un mot de passe. Retourne les jetons d'accès et de rafraîchissement.

Corps de la requête

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "password": "securepassword"
}

Réponse

json

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe"
  }
}

POST/v1/auth/signup

Inscription par e-mail

Enregistrez un nouvel utilisateur. Retourne des jetons ou déclenche le flux de vérification par e-mail.

Corps de la requête

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "password": "securepassword",
  "displayName": "John Doe"
}

Réponse

json

{
  "status": "verification_required",
  "message": "Check your email for a verification code"
}

POST/v1/auth/verify-email

Vérifier l'e-mail

Vérifiez une adresse e-mail avec le code OTP à 6 chiffres envoyé après l'inscription.

Corps de la requête

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "code": "123456"
}

Réponse

json

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": { ... }
}

POST/v1/auth/refresh

Rafraîchir le jeton

Échangez un jeton de rafraîchissement contre un nouveau jeton d'accès avant son expiration.

Corps de la requête

json

{
  "refreshToken": "rt_abc123..."
}

Réponse

json

{
  "accessToken": "eyJhbGci...",
  "expiresIn": 3600
}

POST/v1/auth/signout

Déconnexion

Invalidez la session courante et révoquez le jeton de rafraîchissement.

Réponse

json

{ "success": true }