add alternative line for cursor based pagination

This commit is contained in:
hzrd149
2025-03-30 10:13:35 +01:00
parent a63959f1e0
commit 39d1ae9e93

View File

@@ -73,7 +73,9 @@ 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 `/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 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 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