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

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

Создайте ключ в разделе «API-ключи» кабинета и передавайте его в заголовке Authorization: Bearer.

curl -s https://urly.uz/api/v1/links \
  -H "Authorization: Bearer urly_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"destination_url":"https://example.uz/sale","slug":"kuz2026"}'

Эндпоинты

Эндпоинты
Метод	Путь	Право	Назначение
`GET`	`/api/v1/plans`	—	Публичный список тарифов
`GET`	`/api/v1/links`	`links:read`	Список ссылок (поиск и постраничный вывод)
`POST`	`/api/v1/links`	`links:write`	Создать ссылку
`GET`	`/api/v1/links/{id}`	`links:read`	Получить ссылку
`PATCH`	`/api/v1/links/{id}`	`links:write`	Изменить ссылку
`DELETE`	`/api/v1/links/{id}`	`links:write`	Удалить ссылку

Ошибки

Каждая ошибка возвращается со стабильным кодом (например, SLUG_TAKEN) и текстом на выбранном языке.

{"error":{"code":"SLUG_TAKEN","message":"…","request_id":"0192…"}}

Ограничения

Число запросов зависит от тарифа. При превышении возвращается ответ 429 и заголовок Retry-After.