File tree Expand file tree Collapse file tree 1 file changed +33
-1
lines changed Expand file tree Collapse file tree 1 file changed +33
-1
lines changed Original file line number Diff line number Diff line change @@ -982,7 +982,39 @@ The `@nextLink` MAY be populated using either server-driven paging or client-dri
982
982
983
983
#### 9.8.2. Server-driven paging
984
984
985
- The server MAY provide
985
+ The server MAY provide server-driven paging by populating the continuation token with a ` $skiptoken ` query parameter.
986
+ The ` $skiptoken ` value is opague for clients and its structure should not be assumed.
987
+ ` $skiptoken ` values SHOULD expire after some period of time.
988
+
989
+ Example:
990
+
991
+ ``` http
992
+ GET http://api.contoso.com/v1.0/people HTTP/1.1
993
+ Accept: application/json
994
+
995
+ HTTP/1.1 200 OK
996
+ Content-Type: application/json
997
+
998
+ {
999
+ ...,
1000
+ "value": [...],
1001
+ "@nextLink": "http://api.contoso.com/v1.0/people?$skiptoken={opaquetoken}"
1002
+ }
1003
+ ```
1004
+
1005
+ ``` http
1006
+ GET http://api.contoso.com/v1.0/people?$skiptoken={opaquetoken} HTTP/1.1
1007
+ Accept: application/json
1008
+
1009
+ HTTP/1.1 200 OK
1010
+ Content-Type: application/json
1011
+
1012
+ {
1013
+ ...,
1014
+ "value": [...],
1015
+ "@nextLink": "http://api.contoso.com/v1.0/people?$skiptoken={opaquetoken2}"
1016
+ }
1017
+ ```
986
1018
987
1019
#### 9.8.3. Client-driven paging
988
1020
Clients MAY use _ $top_ and _ $skip_ query parameters to specify a number of results to return and an offset into the collection.
You can’t perform that action at this time.
0 commit comments