API – začínáme

QLI.fr má REST API pro vytváření odkazů, analytiku, QR kódy a prémiové aliasy. API je součástí tarifů od Starter.

1. Vytvořte API token

V aplikaci otevřete Nastavení → API tokeny, zadejte název a vyberte jen potřebná oprávnění (scopes). Token se zobrazí pouze jednou – uložte ho do správce tajemství.

Přejít na API tokeny

2. Zavolejte API

Token posílejte v hlavičce Authorization. Příklad vytvoření krátkého odkazu:

Příklad požadavku 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. Specifikace

Kompletní popis endpointů, chyb a stránkování je ve specifikaci OpenAPI 3.1.

Stáhnout specifikaci OpenAPI (YAML)

Chyby

Chyby mají vždy tvar {code, message, request_id, details}. Při kontaktu s podporou uveďte request_id.

Limity

Měsíční kvóta volání API závisí na tarifu; pro token platí limit 600 požadavků za minutu.