Привет, !
Куплено почт
—
Активных сегодня
—
Запросов за месяц
—
Лимит API
—
Полная статистика появится здесь в ближайшее время.
Настройки
Загрузка...
API документация
Основной домен API: https://api.mailybizmail.live
Авторизация происходит через заголовок Authorization: Bearer <твой_токен>. Токен указан на вкладке «Настройки».
Все запросы используют метод POST и заголовок Content-Type: application/json.
Получение писем с почты
POST
https://api.mailybizmail.live/v1/letters
Заголовки
| Заголовок | Значение |
|---|---|
Authorization | Bearer <твой_токен> |
Content-Type | application/json |
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
email | string | да | Адрес почтового ящика |
password | string | да | Пароль от почтового ящика |
filters.search | string | нет | Поиск по теме, тексту письма и отправителю |
filters.star | boolean | нет | Фильтр по избранным письмам |
Пример запроса
{
"email": "[email protected]",
"password": "12345678",
"filters": {
"search": "код подтверждения",
"star": false
}
}
Пример ответа
{
"data": {
"letters": [
{
"id": "9273596c-584b-5d70-b3dc-4e3b89b96bc6",
"sender": "[email protected]",
"sender_name": "Example",
"subject": "Тема письма",
"letter": {
"html": "<html>...</html>",
"text": "Текст письма"
},
"star": false,
"date": 1729076880
}
]
}
}
Описание полей ответа
| Поле | Тип | Описание |
|---|---|---|
id | string | Уникальный идентификатор письма (стабилен при повторных запросах) |
sender | string | Email отправителя |
sender_name | string | Имя отправителя |
subject | string | Тема письма |
letter.html | string | HTML-версия письма |
letter.text | string | Текстовая версия письма |
star | boolean | Помечено ли письмо как избранное |
date | number | Дата письма, Unix-timestamp (секунды) |
Ограничения
— Возвращаются максимум 30 последних писем (после применения фильтров)
— Поиск и фильтрация выполняются среди 100 последних писем в ящике
— Обращение к API не помечает письма как прочитанные
Лимит запросов
120 запросов в минуту на один API-токен. При превышении возвращается ошибка 429.
Возможные ошибки
| Код | Описание |
|---|---|
400 | Не указан email или пароль / неверный формат |
401 | Отсутствует или недействителен токен |
401 | Неверные данные для входа в почту (email/пароль) |
429 | Превышен лимит запросов |
Пример ошибки
{
"error": "Недействительный токен"
}