search

WhiteHouse / api-standards

3.08k stars 901 forks source link

A few CDC Enhancements #34

Open tho1-cdc opened 11 years ago

tho1-cdc commented 11 years ago

At CDC we have been working developers at HHS and codeveloping our new API with this specification on our Content Services project. We have two suggested enhancements.

  1. Allowing for multiple message returns in the JSON return set to provide independent information for bulk actions and where possible deeper information to the caller. "status":200,"message":[],
  2. Move the pagination information into a separate structure to better delineate it and provide more navigation information.

pagination":{"count":3384, "offset":0, "page":1, "max":2, "totalPages":1692, "sort":"datepublished Desc", "currentUri":"http://prototype.cdc.gov/api/v1/resources/media/?max=2", "previousUri":null, "nextUri":"http://prototype.cdc.gov/api/v1/resources/media/?max=2&page=2&rsid=e5f13d08-fd94-413e-ae0e-9112c5c88415"} }