Документация по взаимодействию с почтой для разработчиков

Современное RESTful API для управления почтовыми аккаунтами и доменами.

Базовая информация

  • Base URL: https://api.mail73.ru/api/v1
  • Format: JSON
  • Authentication: API Key в заголовке X-API-KEY
  • Rate Limit: 15 запросов в минуту

Аутентификация

Все запросы к API требуют аутентификации через API ключ:

curl -H "X-API-KEY: your_api_key_here" https://api.mail73.ru/api/v1/me

Получить API ключ можно в личном кабинете в разделе настроек.

Структура ответов

Успешный ответ (2xx)

{
  "success": true,
  "code": 200,
  "data": {
    "id": 1,
    "name": "example"
  }
}

Ошибка (4xx, 5xx)

{
  "success": false,
  "code": 422,
  "message": "Validation failed"
}

Пагинированный ответ

{
  "success": true,
  "code": 200,
  "data": {
    "items": [...],
    "pagination": {
      "total": 100,
      "per_page": 20,
      "current_page": 1,
      "last_page": 5
    }
  }
}