API hujjatlari
URLY REST API havolalarni dasturiy yaratish va boshqarish imkonini beradi.
Autentifikatsiya
Kabinetdagi «API kalitlari» boʻlimida kalit yarating va uni Authorization: Bearer sarlavhasida yuboring.
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"}'Endpointlar
| Metod | Yoʻl | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /api/v1/plans | — | Ommaviy tariflar roʻyxati |
GET | /api/v1/links | links:read | Havolalar roʻyxati (qidiruv va sahifalash) |
POST | /api/v1/links | links:write | Havola yaratish |
GET | /api/v1/links/{id} | links:read | Havolani olish |
PATCH | /api/v1/links/{id} | links:write | Havolani tahrirlash |
DELETE | /api/v1/links/{id} | links:write | Havolani oʻchirish |
Xatolar
Har bir xato barqaror kod (masalan, SLUG_TAKEN) va tanlangan tildagi matn bilan qaytariladi.
{"error":{"code":"SLUG_TAKEN","message":"…","request_id":"0192…"}}Cheklovlar
Soʻrovlar soni tarifga bogʻliq. Limitdan oshganda 429 javobi va Retry-After sarlavhasi qaytadi.