REST API & Документация

Интеграция с ботами, Playwright и настройка собственных доменов.

🌐

1. Настройка и подключение собственного домена (DNS)

Чтобы получать почту на ваш личный домен, пропишите следующие 2 записи в DNS-панели вашего регистратора (Reg.ru, Cloudflare, Namecheap, Ahost):

Тип: A | Хост/Имя: mail | Значение: 89.124.81.49 | TTL: Auto Тип: MX | Хост/Имя: @ | Значение: mail.yourdomain.com. | Приоритет: 10

💡 После добавления записей отправьте заявку через кнопку «+ Добавить свой домен». Система автоматически проверит MX-запись.

⚡

2. Системные эндпоинты и Домены (System & Domains API)

Получение списка доступных доменов и проверка статуса сервиса.

GET /api/domains

Список всех активных доменов для генерации адресов.

curl -X GET "https://mail.riot.uz/api/domains"

GET /api/status

Статус сервера, uptime, статистика и объявление администратора.

curl -X GET "https://mail.riot.uz/api/status"

POST /api/domains

Отправить заявку на подключение собственного домена.

curl -X POST "https://mail.riot.uz/api/domains" \ -H "Content-Type: application/json" \ -d '{"domain": "mycustomsite.org"}'
📬

3. Входящие письма и Инбокс (Inbox & Messages API)

Автоматизация для Playwright, Puppeteer, Python Selenium и Telegram-ботов.

GET /api/inbox/:domain/:username?limit=50&offset=0

Получить список входящих писем ящика с пагинацией (limit/offset). Если ящик защищен PIN-кодом, вернется "isProtected": true (требуется предварительная разблокировка через /api/inbox/unlock).

curl -X GET "https://mail.riot.uz/api/inbox/riot.uz/alex1234?limit=50&offset=0"

POST /api/inbox/unlock

Разблокировка защищенного паролем ящика. Возвращает временный Bearer-токен сессии для доступа к письмам.

curl -X POST "https://mail.riot.uz/api/inbox/unlock" \ -H "Content-Type: application/json" \ -d '{"email": "alex1234@riot.uz", "pin": "123456"}'

GET /api/message/:id

Получить полное тело письма: санитизированный HTML, плоский текст, список вложений и автоматически распознанный код подтверждения (OTP). Для защищенных ящиков передавайте заголовок Authorization: Bearer <token>.

curl -X GET "https://mail.riot.uz/api/message/42" \ -H "Authorization: Bearer YOUR_SESSION_TOKEN"

GET /api/message/:id/attachment/:attachmentId

Скачать прикрепленный файл / вложение письма в безопасном режиме.

curl -O -J "https://mail.riot.uz/api/message/42/attachment/3"

DELETE /api/inbox/:domain/:username

Очистить все письма и вложения указанного почтового ящика.

curl -X DELETE "https://mail.riot.uz/api/inbox/riot.uz/alex1234"
🎯

4. Генераторы почтовых алиасов и Боты (Email Generators & Bot OTP API)

Массовая генерация уникальных вариантов для Gmail, Yandex, Mail.ru, iCloud и автопоиск кодов для автоматизации.

GET /api/gmail-generator?email=...&provider=icloud&includeIcloudDomains=1

Генерация сотен комбинаций точек (.), дефисов (-), тегов (+tag) и доменов для Gmail, Yandex, Mail.ru и Apple iCloud.

curl -X GET "https://mail.riot.uz/api/gmail-generator?email=targetuser@icloud.com&includeIcloudDomains=1"

GET /api/gmail-code?email=...&autoDelete=1

Быстрый поиск последнего входящего кода подтверждения (OTP) по email-адресу. Требуется API-ключ бота. Опция autoDelete=1 автоматически удаляет письмо после извлечения кода.

curl -X GET "https://mail.riot.uz/api/gmail-code?email=targetuser%2Bpromo@gmail.com&autoDelete=1" \ -H "X-Bot-Key: YOUR_SECRET_BOT_API_KEY"
🔌

5. Real-Time WebSockets (Socket.IO Integration)

Мгновенное получение входящих писем без периодического опроса (polling).

const socket = io("https://mail.riot.uz"); // 1. Подписаться на получение писем конкретного ящика (комнаты) socket.emit("watch_address", "alex1234@riot.uz"); // 2. Слушать событие нового входящего письма socket.on("incoming_email", (data) => { const email = JSON.parse(data); console.log("Новое письмо от:", email.sender); console.log("Тема:", email.subject); console.log("ID сообщения:", email.emailid); });