Пагинация и идемпотентность

Курсорная пагинация и Idempotency-Key для безопасных повторов.

1 мин чтения Разделов: 2

Курсорная пагинация#

GET /api/v1/links разбивается на страницы с помощью курсора. limit нормализуется до диапазона 1–100. Поле meta в ответе содержит hasNext, nextCursor и общее число total.

list-links.sh

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

Параметр page принимается для обратной совместимости, но новым клиентам следует использовать курсор. Изменённый или повреждённый курсор возвращает 400.

Idempotency-Key#

Idempotency-Key поддерживается при создании, обновлении, удалении и во всех подресурсах маршрута.

Тот же ключ и тот же payload: первый ответ повторяется без изменений, квота не списывается дважды.
Тот же ключ, другой payload: 409 Conflict.

Генерируйте новый ключ для каждой логической операции (например, UUID) и при сетевой ошибке повторяйте запрос с тем же ключом.

Чего-то не хватает или есть ошибка? Напишите в поддержку; приложив значение X-Request-Id из ответа, вы ускорите решение.