Получение токена пользователя

API 0.16.0OpenAPIllms-full.txt

POST/v1/auth/token

Выдаёт токен доступа на один час по логину и паролю. Укажите mode=account для доступа ко всем ящикам аккаунта или mode=mailbox для доступа к одному адресу. Передавайте access_token в заголовке Authorization: Bearer <access_token>.

Авторизация и области доступа · Ошибки и повторы

Запрос

curl -X POST 'https://adapt-mail.com/v1/auth/token' \
  -H 'Content-Type: application/json' \
  --data '{"login":"user-123","password":"<password>"}'

Тело запроса · application/json

object

loginОбязательно

string

passwordОбязательно

string

minLength: 1

maxLength: 128

mode

string

Допустимые значения: "account" "mailbox"

По умолчанию: "account"

Неизвестные поля не принимаются.

Ответы

200 Успешный ответ

application/json

object

access_token

string

token_type

string

"Bearer"

expires_in

integer

3600

mailbox_id

Вариант 1

integer

Вариант 2

null

401 Требуется вход

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

403 Нет доступа

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

404 Ресурс не найден

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

409 Конфликт состояния

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

422 Ошибка валидации

application/json

object

detail

array

Элементы массива

object

locОбязательно

array

Элементы массива

Вариант 1

string

Вариант 2

integer

msgОбязательно

string

typeОбязательно

string

429 Слишком много запросов

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

503 Временная недоступность

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object