khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-03 02:09:45 +07:00
Code Issues Packages Projects Releases Wiki Activity

feat(developer_manual): document Nextcloud DAV pagination

Browse Source 
Signed-off-by: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
This commit is contained in:
Benjamin Gaussorgues
2025-03-31 16:36:09 +02:00
parent fad8f8b524
commit 4a367fc9db
1 changed files with 18 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_31.rst
View File

@@ -154,6 +154,24 @@ Changed APIs
- ``DATETIME_TZ`` for fields that will (de)serialized as ``\DateTime`` instances with both the time part set and with timezone information.
- ``DATETIME_TZ_IMMUTABLE`` for fields that will (de)serialized as ``\DateTimeImmutable`` instances with both the time part set and with timezone information.
- It's now possible to paginate DAV requests with new headers.
- First request should contains the following headers:
- ``X-NC-Paginate: true`` enables the functionality
- ``X-NC-Paginate-Count: X`` sets the number of results per page (default 100)
- Server will answer with new headers:
- ``X-NC-Paginate-Total`` indicates the total number of results.
- ``X-NC-Paginate-Token`` gives a token to access other pages of the same result.
- Issue new requests with token:
- ``X-NC-Paginate-Token: xxx`` contains the token as sent by the server
- ``X-NC-Paginate-Count: X`` sets the number of results per page (default 100)
- ``X-NC-Paginate-Offset: Y`` sets the offset (number of ignored results) for the required page (usually "page_number × page_size")
Deprecated APIs
^^^^^^^^^^^^^^^