Documentation is weak for Request and Rest Stores

[cgaeking]

Design of JSON-Responses for Request and Rest Stores

It took me quite some time to research until I finally figured out, that the OnDemandGrid /-List does not work with Request or Rest Stores if the response doesn't include the total amount of results.

There are actually 2 different supported formats of json responses that are supported.
Please, include this in your documentation.

First way:

Include a header in the response like:
Content-Range:items 0-24/500

Data:

[{"id":0,"name":"Item 0","comment":"hello"},{"id":1,"name":"Item 1","comment":"hello"},
{"id":2,"name":"Item 2","comment":"hello"},{"id":3,"name":"Item 3","comment":"hello"},
{"id":4,"name":"Item 4","comment":"hello"},{"id":5,"name":"Item 5","comment":"hello"},...]

Second way:

Include a total field in the json:

{
  "total":500,
  "items":
     [{"id":0,"name":"Item 0","comment":"hello"},
      {"id":1,"name":"Item 1","comment":"hello"},
      {"id":2,"name":"Item 2","comment":"hello"},
     {"id":3,"name":"Item 3","comment":"hello"},...
     ]
}