From 39d1ae9e93d873c995ff48c46f7650d3d3763383 Mon Sep 17 00:00:00 2001 From: hzrd149 Date: Sun, 30 Mar 2025 10:13:35 +0100 Subject: [PATCH] add alternative line for cursor based pagination --- buds/02.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/buds/02.md b/buds/02.md index 36330c0..4c6686d 100644 --- a/buds/02.md +++ b/buds/02.md @@ -73,7 +73,9 @@ Example Authorization event: The `/list/` endpoint MUST return a JSON array of [Blob Descriptor](#blob-descriptor) that where uploaded by the specified pubkey -The endpoint MUST support `limit`, `offset` query parameters for pagination. The returned array of blob descriptors MUST be sorted by the `uploaded` date in descending order +The endpoint MUST support `limit`, `offset` query parameters for offset limit based pagination. The returned array of blob descriptors MUST be sorted by the `uploaded` date in descending order + +The endpoint MUST support `cursor` and`limit` query parameters for cursor based pagination. The `cursor` parameter MUST be the `sha256` hash of the last blob in the previous page. The returned array of blob descriptors MUST be sorted by the `uploaded` date in descending order and should not include the blob at the cursor Servers may reject a list for any reason and MUST respond with the appropriate HTTP `4xx` status code and an error message explaining the reason for the rejection