Оглавление

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

Все запросы к MassAccess API аутентифицируются через API-ключ в заголовке X-API-Key.

Получение API-ключа

API-ключ генерируется в личном кабинете в разделе Настройки → API.

ВажноХраните API-ключ в безопасности. Не передавайте его третьим лицам и не публикуйте в публичных репозиториях.

Использование API-ключа

Ключ передаётся в заголовке X-API-Key каждого запроса:

Заголовки запроса

ЗаголовокЗначениеОбязателен
X-API-KeystringДа
Content-Typeapplication/jsonДа

Примеры

bash
curl -X POST /api/v1/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "phone_number": "12345678901",
  "text": "Test"
}'

# 202 Accepted
{
  "status": "accepted",
  "data": {
    "event_id": "...",
    "status": "new"
  }
}

Ошибки аутентификации

При неверном или отсутствующем ключе API возвращает HTTP 401:

json
# 401 Unauthorized
{
  "detail": "Invalid or missing API key"
}