🔐Авторизация в Inbox API

Чтобы получить токен доступа и начать работу с почтовым API, необходимо выполнить POST-запрос на Endpoint авторизации.

🔎 Endpoint

Чтобы получить токен доступа и начать работу с почтовым API, необходимо выполнить POST-запрос на Endpoint авторизации.

POST https://api.orangemail.io/inbox/users/auth

📥 Тело запроса (POST-данные)

Передаются в формате application/x-www-form-urlencoded или application/json:

Параметр	Тип	Обязательный	Описание
email	string	✅	Email пользователя
password	string	✅	Пароль от почтового аккаунта

📦 Ответ

Ответ приходит в формате JSON. Возможны следующие сценарии:

✅ Успешная авторизация

"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."

Возвращается строковое значение токена доступа (JWT или иного формата), которое необходимо использовать для дальнейших запросов в API.

⚠️ Авторизация с устаревшим или обновлённым паролем

{
  "type": "new_password",
  "date": 1719974400
}

• type: new_password — используется новый пароль, сообщается дата его смены.

• date: UNIX timestamp, когда пароль был обновлён.

Если вы используете старый пароль, API также предупредит:

{
  "type": "old_password",
  "date": 1719705600
}

• type: old_password — указывает, что вы вошли со старым паролем.

• date: дата последнего изменения пароля (в формате UNIX).

❌ Ошибка авторизации

{
  "error": "Invalid credentials"
}

• error: текст ошибки, например "Invalid credentials" или "Missing fields".

📘 Пример запроса на curl

curl -X POST https://api.orangemail.io/inbox/users/auth \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "password123"}'