API – pierwsze kroki

QLI.fr udostępnia REST API do tworzenia linków, analityki, kodów QR i aliasów premium. API jest dostępne w planach od Starter.

1. Utwórz token API

W aplikacji otwórz Ustawienia → Tokeny API, wpisz nazwę i wybierz tylko potrzebne uprawnienia (scopes). Token jest wyświetlany tylko raz – zapisz go w menedżerze sekretów.

Przejdź do tokenów API

2. Wywołaj API

Token przesyłaj w nagłówku Authorization. Przykład utworzenia krótkiego linku:

Przykładowe żądanie 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. Specyfikacja

Pełny opis endpointów, błędów i stronicowania znajduje się w specyfikacji OpenAPI 3.1.

Pobierz specyfikację OpenAPI (YAML)

Błędy

Błędy mają zawsze postać {code, message, request_id, details}. Kontaktując się z pomocą techniczną, podaj request_id.

Limity

Miesięczny limit wywołań API zależy od planu; dla tokenu obowiązuje limit 600 żądań na minutę.