API VookMail для разработчиков
Создавайте временные ящики и читайте письма из своих приложений через простой REST API. Ответы в формате JSON.
Аутентификация
Передавайте API-ключ в заголовке Authorization. Ключи выдаёт владелец сайта.
curl https://www.vookmail.com/api/v1/domains \
-H "Authorization: Bearer vk_your_key"Эндпоинты
Базовый URL: https://www.vookmail.com/api/v1
| Метод | Путь | Описание |
|---|---|---|
| GET | /domains | Список доступных доменов |
| POST | /mailboxes | Создать ящик. Тело запроса: имя пользователя и домен, оба необязательны |
| GET | /mailboxes/{address} | Данные ящика и срок действия |
| POST | /mailboxes/{address}/extend | Продлить срок жизни ящика |
| DELETE | /mailboxes/{address} | Закрыть ящик и удалить его письма |
| GET | /mailboxes/{address}/messages?after={id} | Список писем с найденными кодами и ссылками |
| GET | /mailboxes/{address}/messages/{id} | Прочитать одно письмо: очищенный HTML, текст и вложения |
| DELETE | /mailboxes/{address}/messages/{id} | Удалить одно письмо |
| GET | /mailboxes/{address}/messages/{id}/attachments/{attachment} | Скачать вложение |
Пример
curl -X POST https://www.vookmail.com/api/v1/mailboxes \
-H "Authorization: Bearer vk_your_key" \
-H "Content-Type: application/json" \
-d '{"username":"myapp"}'
{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}Ошибки и лимиты
При ошибках возвращается HTTP-статус с полями error.code и error.message. У каждого ключа есть лимит запросов в минуту; при превышении возвращается статус 429.