API – erste Schritte

QLI.fr bietet eine REST-API zum Erstellen von Links, für Analysen, QR-Codes und Premium-Aliase. Die API ist ab dem Tarif Starter enthalten.

1. API-Token erstellen

Öffnen Sie in der App Einstellungen → API-Tokens, geben Sie einen Namen ein und wählen Sie nur die nötigen Berechtigungen (Scopes). Der Token wird nur einmal angezeigt – speichern Sie ihn in einem Secrets-Manager.

Zu den API-Tokens

2. API aufrufen

Senden Sie den Token im Header Authorization. Beispiel für das Erstellen eines Kurzlinks:

Beispielanfrage mit 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. Spezifikation

Alle Endpunkte, Fehler und die Paginierung sind in der OpenAPI-3.1-Spezifikation beschrieben.

OpenAPI-Spezifikation herunterladen (YAML)

Fehler

Fehler haben immer die Form {code, message, request_id, details}. Geben Sie bei Kontakt mit dem Support die request_id an.

Limits

Das monatliche API-Kontingent hängt vom Tarif ab; pro Token gilt ein Limit von 600 Anfragen pro Minute.