API – első lépések

Az QLI.fr REST API-t kínál linkek létrehozásához, analitikához, QR-kódokhoz és prémium aliasokhoz. Az API a Starter csomagtól érhető el.

1. Hozzon létre API-tokent

Az alkalmazásban nyissa meg a Beállítások → API-tokenek menüt, adjon meg egy nevet, és csak a szükséges jogosultságokat (scopes) válassza ki. A token csak egyszer jelenik meg – mentse el egy titokkezelőbe.

Ugrás az API-tokenekhez

2. Hívja meg az API-t

A tokent az Authorization fejlécben küldje. Példa rövid link létrehozására:

Példa cURL-kérés
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. Specifikáció

A végpontok, hibák és a lapozás teljes leírása az OpenAPI 3.1 specifikációban található.

OpenAPI-specifikáció letöltése (YAML)

Hibák

A hibák formája mindig {code, message, request_id, details}. Az ügyfélszolgálattal való kapcsolatfelvételkor adja meg a request_id értékét.

Limitek

A havi API-kvóta a csomagtól függ; tokenenként percenként legfeljebb 600 kérés engedélyezett.