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

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

Каждый запрос требует заголовок Authorization с Bearer-токеном. Создайте его в веб-почте: Настройки → API-ключи — необработанный токен показывается один раз, при создании.

Создать ключ или отправлять через этот эндпоинт может только ящик на тарифе с доступом к API. Отправка с ящика, тариф которого этого не включает, вернёт 403.

Отправка сообщения

POST https://api.unet.az/api/v1/send

curl -X POST https://api.unet.az/api/v1/send \
  -H "Authorization: Bearer umk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Hello from the API",
    "body_text": "Sent with POST /api/v1/send"
  }'

Поля запроса

Ответ

Успешная отправка возвращает 201 с созданным сообщением, включая id (полезно для ваших собственных записей) и delivery_status, который изначально имеет значение «pending» — сама доставка происходит асинхронно.

HTTP/1.1 201 Created

{
  "id": 149,
  "subject": "Hello from the API",
  "direction": "outbound",
  "delivery_status": "pending",
  "sent_at": "2026-08-01T08:06:06.000000Z",
  "recipients": [
    { "type": "to", "address": "[email protected]" }
  ]
}

Лимиты скорости

У каждого тарифа есть часовой и/или месячный лимит отправки. Они общие для всех каналов отправки одного ящика — веб-почта, API и отправка по SMTP используют один и тот же пул, а не отдельные. Превышение любого лимита возвращает 429 с машиночитаемым кодом ошибки:

HTTP/1.1 429 Too Many Requests

{
  "error": "hour_limit_exceeded",
  "message": "You've reached your Pro plan's limit of 100 sent messages per hour."
}

Ответы с ошибками