Войти
Документация

API McxMail

HTTP API на FastAPI. Мультидоменная регистрация ящиков через API-токены, чтение входящих и извлечение кодов из писем.

Base URL
https://mcxmail.online
GET
/api/domains

Список активных доменов

Возвращает список всех активных доменов. Не требует авторизации.

Ответ
{
  "domains": ["mcxmail.ru", "coolmail.ru"]
}
POST
/api/get_messages

Получить последние письма

Возвращает список последних писем из INBOX по IMAP. Не требует токен.

Запрос
{
  "email": "artem@mcxmail.ru",
  "password": "SuperSecret123"
}

// query: ?limit=5
Ответ
[
  {
    "uid": "1042",
    "subject": "Добро пожаловать",
    "sender": "team@mcxmail.ru",
    "text": "Спасибо, что выбрали...",
    "html": "<p>...</p>"
  }
]
POST
/api/get_latest_message

Получить последнее ПИСЬМО

Возвращает ровно одно, самое свежее письмо из INBOX по IMAP (в виде объекта, а не списка). Не требует токен.

Запрос
{
  "email": "artem@mcxmail.ru",
  "password": "SuperSecret123"
}
Ответ
{
  "uid": "1042",
  "subject": "Добро пожаловать",
  "sender": "team@mcxmail.ru",
  "text": "Спасибо, что выбрали...",
  "html": "<p>...</p>"
}
POST
/api/extract_data

Найти письмо и вытащить код/ссылку

Парсит последнее письмо и возвращает все найденные цифровые коды и ссылки.

Запрос
{
  "email": "artem@mcxmail.ru",
  "password": "SuperSecret123"
}

// query: ?target_sender=noreply@service.io
Ответ
{
  "status": "success",
  "subject": "Ваш код подтверждения",
  "found_codes": ["482910"],
  "found_links": ["https://service.io/verify"],
  "raw_text": "Используйте этот код..."
}

Отправка писем

На данный момент сервис работает только на приём и чтение. Отправка писем через API не поддерживается.