Obtenir un jeton utilisateur
/v1/auth/tokenÉmet un jeton d'accès pendant une heure en fonction de l'identifiant et du mot de passe. Spécifiez mode=account pour accéder à toutes les boîtes aux lettres du compte ou mode=mailbox pour accéder à une adresse. Passez access_token dans l’en-tête Authorization: Bearer <access_token>.
Zones d’autorisation et d’accès · Erreurs et répétitions
Demande
curl -X POST 'https://adapt-mail.com/v1/auth/token' \ -H 'Content-Type: application/json' \ --data '{"login":"user-123","password":"<password>"}'Corps de la demande · application/json
object
loginNécessairementstringpasswordNécessairementstringminLength: 1maxLength: 128modestringValeurs valides:
"account""mailbox"Défaut:
"account"
Les champs inconnus ne sont pas acceptés.
Réponses
200 Réponse réussie
application/json
object
access_tokenstringtoken_typestring"Bearer"expires_ininteger3600mailbox_id- Option 1
integerOption 2null
401 Connexion requise
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject
403 Pas d'accès
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject
404 Ressource introuvable
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject
409 Conflit d'État
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject
422 Erreur de validation
application/json
object
detailarrayÉléments du tableauobjectlocNécessairementarrayÉléments du tableauOption 1stringOption 2integermsgNécessairementstringtypeNécessairementstring
429 Trop de demandes
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject
503 Indisponibilité temporaire
application/json
object
detail- Option 1
stringOption 2objectcodestringmessagestring
Option 3arrayÉléments du tableauobject