elphastori commented on issue #13119:
URL: https://github.com/apache/iceberg/issues/13119#issuecomment-2904798383

   Thanks for linking the [rest 
spec](https://github.com/apache/iceberg/blob/91dff9886e6e6c494f6a970129f4c08487c98a0d/open-api/rest-catalog-open-api.yaml#L2018C1-L2041C21).
   
   >        An opaque token that allows clients to make use of pagination for 
list APIs
   >        (e.g. ListTables). Clients may initiate the first paginated request 
by sending an empty
   >        query parameter `pageToken` to the server.
   
   Based on this description, the REST catalog is technically behaving as 
expected.
   
   - Works: 
http://localhost:8181/v1/namespaces/default/tables?pageSize=1&pageToken=
   - Doesn't work: http://localhost:8181/v1/namespaces/default/tables?pageSize=1
   
   The API expects the first request to have an *empty* `pageToken`, rather 
than omitting the parameter entirely. While this aligns with the current spec, 
it’s not the most intuitive developer experience.
   
   Ideally, I would suggest updating the spec description to something like:
   
   >  Clients can initiate the first paginated request *either* without the 
`pageToken` query parameter or with an empty one.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org

Reply via email to