D
Drrsan Platform API v2
Сервис доступен (HTTP/2, TLS 1.3)

Региональный шлюз API

Шлюз обработки клиентских запросов и синхронизации сессионных данных платформы Drrsan в центральном регионе.

Параметры подключения

Шлюз принимает входящие защищенные HTTPS-запросы от клиентских веб-интерфейсов и мобильных приложений. Все соединения защищены современными стандартами шифрования.

Параметр Спецификация
Базовый FQDN msk-central-edge.drrsan.dev
Протокол передачи HTTPS / HTTP/2 (ALPN: h2, h1)
Безопасность соединения TLS 1.3 / TLS 1.2 (RFC 8446)
Форматы данных JSON (application/json), Octet-Stream
Сжатие содержимого Zstandard (zstd), Gzip

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

Все запросы к закрытым маршрутам требуют передачи авторизационного токена в заголовке Authorization:

Authorization: Bearer <CLIENT_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json

Запросы без валидного токена отклоняются с кодом ошибки 401 Unauthorized.

POST /api/v2/sync

Синхронизация данных сессии

Основной маршрут пакетной синхронизации локального состояния пользовательских приложений с сервисной базой данных.

Пример запроса:

curl -X POST https://msk-central-edge.drrsan.dev/api/v2/sync \
  -H "Authorization: Bearer sec_tok_sample_9841f" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "app-web-01",
    "sync_action": "heartbeat",
    "timestamp": 1791305200
  }'

Пример успешного ответа:

{
  "status": "success",
  "sync_state": "synchronized",
  "processed_at": 1791305200
}
GET /api/v2/status

Проверка состояния сервиса

Маршрут для внешней автоматической проверки доступности и времени отклика шлюза.

Ответ сервиса:

{
  "status": "healthy",
  "service": "edge-gateway",
  "region": "msk-central",
  "cluster": "dc-prod-01"
}

Коды ответов шлюза

Код Статус Описание
200 OK Успешно Запрос успешно обработан шлюзом
400 Bad Request Ошибка формата Некорректный синтаксис тела запроса
401 Unauthorized Не авторизован Отсутствует или недействителен токен доступа
429 Too Many Requests Лимит превышен Превышена допустимая частота запросов
500 Server Error Внутренняя ошибка Временная недоступность сервиса обработки