From 3ae2361b416991389008cc27bf210e8bd46b6414 Mon Sep 17 00:00:00 2001 From: hzrd149 Date: Mon, 12 May 2025 09:38:25 -0500 Subject: [PATCH] switch to `cursor` and `limit` with optional date filters --- buds/02.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/buds/02.md b/buds/02.md index 4c6686d..22a4566 100644 --- a/buds/02.md +++ b/buds/02.md @@ -73,11 +73,11 @@ 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 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 +The endpoint MUST support `since` and `until` query parameters to filter the list of blobs by their `uploaded` date, although it is not recommended for clients to use these parameters for pagination. + +Servers may reject a list request for any reason and MUST respond with the appropriate HTTP `4xx` status code and an error message explaining the reason for the rejection ### List Authorization (optional)