Returning page meta data


#1

Paging in REST api’s is very common.
Just like naming fields is not mandated in the JSON:API spec the recommendation is to use hyphens.

Would it be a good idea to document a recommendation regarding page meta data? This way api’s could implement this in some consistent recommended way.

E.g.

"meta": {
    "page_info": {
        "number": 1,
        "size": 10,
        "number-of-elements": 10,
        "total-elements": 87,
        "total-pages": 9
    }
},