Pagination et idempotence

Pagination par curseur et Idempotency-Key pour des nouvelles tentatives sans risque.

1 min de lecture 2 sections

Pagination par curseur#

GET /api/v1/links est paginé par curseur. limit est normalisé dans la plage 1–100. Le champ meta de la réponse contient hasNext, nextCursor et le total total.

list-links.sh

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

Le paramètre page est accepté pour la rétrocompatibilité, mais les nouveaux clients doivent utiliser le curseur. Un curseur modifié ou corrompu renvoie 400.

Idempotency-Key#

Idempotency-Key est pris en charge pour create, update, delete et toutes les sous-ressources de route.

Même clé et même payload : la première réponse est renvoyée à l’identique et le quota n’est pas décompté deux fois.
Même clé, payload différent : 409 Conflict.

Générez une nouvelle clé pour chaque opération logique (par ex. un UUID) et réessayez avec la même clé en cas d’erreur réseau.

Il manque quelque chose ou il y a une erreur ? Écrivez à l’équipe d’assistance, en joignant la valeur X-Request-Id de la réponse, vous accélérerez la résolution.