Sayfalama ve idempotency

Cursor pagination ve güvenli tekrar deneme için Idempotency-Key.

1 dk okuma 2 bölüm

Cursor pagination#

GET /api/v1/links cursor ile sayfalanır. limit 1–100 aralığına normalize edilir. Yanıttaki meta alanında hasNext, nextCursor ve toplam total bulunur.

list-links.sh

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

page parametresi geriye uyumluluk için kabul edilir ama yeni istemciler cursor kullanmalıdır. Değiştirilmiş veya bozuk cursor 400 döner.

Idempotency-Key#

Create, update, delete ve tüm route alt kaynaklarında Idempotency-Key desteklenir.

Aynı anahtar ve aynı payload ile tekrar: ilk yanıt aynen tekrar döner, kota iki kez sayılmaz.
Aynı anahtar, farklı payload: 409 Conflict.

Her mantıksal işlem için yeni bir anahtar üretin (ör. UUID) ve ağ hatasında aynı anahtarla tekrar deneyin.

Bir şey eksik veya hatalı mı? Destek ekibine yazın; yanıttaki X-Request-Id değerini eklemek çözümü hızlandırır.