API – початок роботи

QLI.fr має REST API для створення посилань, аналітики, QR-кодів і преміум-аліасів. API входить до тарифів від Starter.

1. Створіть API-токен

У застосунку відкрийте Налаштування → API-токени, введіть назву та оберіть лише потрібні права (scopes). Токен показується лише один раз – збережіть його в менеджері секретів.

Перейти до API-токенів

2. Викличте API

Надсилайте токен у заголовку Authorization. Приклад створення короткого посилання:

Приклад запиту cURL

curl -X POST https://api.ra.sk/v1/links -H "Authorization: Bearer rask_…" -H "Content-Type: application/json" -d '{"destination_url":"https://example.com"}'

3. Специфікація

Повний опис ендпоїнтів, помилок і пагінації наведено в специфікації OpenAPI 3.1.

Завантажити специфікацію OpenAPI (YAML)

Помилки

Помилки завжди мають вигляд {code, message, request_id, details}. Звертаючись до служби підтримки, вкажіть request_id.

Ліміти

Місячна квота викликів API залежить від тарифу; для одного токена діє ліміт 600 запитів на хвилину.