API – začíname

QLI.fr má REST API pre vytváranie odkazov, analytiku, QR kódy a prémiové aliasy. API je súčasťou plánov od Starter.

1. Vytvorte API token

V aplikácii otvorte Nastavenia → API tokeny, zadajte názov a vyberte len potrebné oprávnenia (scopes). Token sa zobrazí iba raz – uložte ho do správcu tajomstiev.

Prejsť na API tokeny

2. Zavolajte API

Token posielajte v hlavičke Authorization. Príklad vytvorenia krátkeho odkazu:

Príklad požiadavky 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. Špecifikácia

Kompletný popis endpointov, chýb a stránkovania je v OpenAPI 3.1 špecifikácii.

Stiahnuť OpenAPI špecifikáciu (YAML)

Chyby

Chyby majú vždy tvar {code, message, request_id, details}. Pri kontakte s podporou uveďte request_id.

Limity

Mesačná kvóta API volaní závisí od plánu; na token platí limit 600 požiadaviek za minútu.