справка

Справочник API

Полный список эндпоинтов управления проектом. Базовый URL: https://api.hexly.dev.

Маршруты шлюза

GET/v1/gateway/routesСписок всех маршрутов проекта
POST/v1/gateway/routesСоздать новый маршрут
PUT/v1/gateway/routes/{{id}}Обновить существующий маршрут
DELETE/v1/gateway/routes/{{id}}Удалить маршрут

Вебхуки

GET/v1/webhooks/subscriptionsСписок подписок на события
POST/v1/webhooks/subscriptionsСоздать подписку на событие
POST/v1/webhooks/deliverОтправить событие вручную
GET/v1/webhooks/{{id}}/attemptsИстория попыток доставки события

Очереди

POST/v1/queues/{{name}}/publishОпубликовать сообщение в очередь
GET/v1/queues/{{name}}/statsСтатистика глубины и скорости обработки очереди

Проект и ключи

GET/v1/keysСписок API-ключей проекта
POST/v1/keysСоздать новый API-ключ
DELETE/v1/keys/{{id}}Отозвать API-ключ

Пример: создание маршрута

curl -X POST https://api.hexly.dev/v1/gateway/routes \
  -H "Authorization: Bearer hx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "path": "/v1/orders",
    "upstream": "https://api.internal/orders",
    "rate_limit": "1000/min"
  }'

# → 201 Created

Пагинация

Все списочные эндпоинты поддерживают курсорную пагинацию через параметры ?limit= и ?cursor=. Ответ содержит поле next_cursor, если результатов больше, чем помещается на одну страницу.