Skip to content

Commit dcf60b6

Browse files
authored
Update Guidelines.md
1 parent f400863 commit dcf60b6

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

Guidelines.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -954,8 +954,9 @@ Client-driven paging enables clients to request only the number of resources tha
954954

955955
Sorting and Filtering parameters MUST be consistent across pages, because both client- and server-side paging is fully compatible with both filtering and sorting.
956956

957-
#### 9.8.1. Server-driven paging
958-
Paginated responses MUST indicate a partial result by including a continuation token in the response.
957+
#### 9.8.1. Continuation tokens
958+
959+
Paginated responses MUST indicate a partial result by including a continuation token in the response using the OData control information `@nextLink`.
959960
The absence of a continuation token means that no additional pages are available.
960961

961962
Clients MUST treat the continuation URL as opaque, which means that query options may not be changed while iterating over a set of partial results.
@@ -976,7 +977,13 @@ Content-Type: application/json
976977
}
977978
```
978979

979-
#### 9.8.2. Client-driven paging
980+
The `@nextLink` MAY be populated using either server-driven paging or client-driven paging (`@nextLink`s generated using client-driven paging should not include the `$top` query parameter).
981+
982+
#### 9.8.2. Server-driven paging
983+
984+
The server MAY provide
985+
986+
#### 9.8.3. Client-driven paging
980987
Clients MAY use _$top_ and _$skip_ query parameters to specify a number of results to return and an offset into the collection.
981988

982989
The server SHOULD honor the values specified by the client; however, clients MUST be prepared to handle responses that contain a different page size or contain a continuation token.

0 commit comments

Comments
 (0)