Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Any resource which returns a collection of items will be subject to pagination. The default page size used in Public Site API is 50 items per page. Although no page size limit is enforced; it is not generally recommend exceeding a page size of 250. In order to keep the documentation concise, none of the API specifications will include information about pagination. Shown below in Figure 1 and Figure 2, is a default template depicting the format of how the pagination of data works within the Public API. For information concerning pagination parameters, please refer to Table 4.

Anchor_Ref361817982_Ref361817982Table 4. Pagination parameters

Key

Description

Page

Specifies the page. When missing, page 1 is presumed.

PageSize

Specifies the page size. When missing, the default size is presumed.

Anchor_Ref361817905_Ref361817905Figure 1  

...

 

...

Code Block
languagejs
titleA sample JSON paginated return

...

linenumberstrue
{
    "Data":

...

 [
      "Item1..",

...


      "Item2.."

...


    ],

...


    "Paging":

...

 {
        "Prevoius": "/api/v1/someResource/?page=1",

...


        "Next": "/api/v1/someResource/?page=3"

...


    }
}

...

Code Block
languagejs
titleA sample JSON paginated return with a custom page size.

...

linenumbers

...

true
{
    "Data":

...

 [
      "Item1..",

...


      "Item2.."

...


    ],

...


    "Paging":

...

 {
        "Prevoius": "/api/v1/someResource/?page=1&pageSize=100",

...


        "Next": "/api/v1/someResource/?page=3&pageSize=100"

...


    }
}