Paginierung und Idempotenz

Cursor-Paginierung und Idempotency-Key für sichere Wiederholungen.

1 Min. Lesezeit 2 Abschnitte

Cursor-Paginierung#

GET /api/v1/links wird mit einem Cursor paginiert. limit wird auf den Bereich 1–100 normalisiert. Das Feld meta in der Antwort enthält hasNext, nextCursor und die Gesamtzahl total.

list-links.sh

curl "https://api.beklio.com/api/v1/links?limit=50&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer bk_live_…"

Der Parameter page wird aus Gründen der Abwärtskompatibilität akzeptiert, neue Clients sollten jedoch den Cursor verwenden. Ein manipulierter oder fehlerhafter Cursor liefert 400.

Idempotency-Key#

Idempotency-Key wird bei Create, Update, Delete und allen Route-Unterressourcen unterstützt.

Gleicher Schlüssel und gleiche Payload: Die erste Antwort wird unverändert wiederholt, das Kontingent wird nicht doppelt gezählt.
Gleicher Schlüssel, andere Payload: 409 Conflict.

Erzeugen Sie für jeden logischen Vorgang einen neuen Schlüssel (z. B. eine UUID) und wiederholen Sie nach einem Netzwerkfehler mit demselben Schlüssel.

Fehlt etwas oder ist etwas falsch? Schreiben Sie dem Support-Team; die Angabe des X-Request-Id-Werts aus der Antwort beschleunigt die Lösung.