switch to cursor and limit with optional date filters

This commit is contained in:
hzrd149
2025-05-12 09:38:25 -05:00
parent 39d1ae9e93
commit 3ae2361b41

View File

@@ -73,11 +73,11 @@ Example Authorization event:
The `/list/<pubkey>` 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)