Monday, May 21, 2018

REST standards


  1. https://github.com/WhiteHouse/api-standards 
  2. https://martinfowler.com/articles/richardsonMaturityModel.html


HTTP METHODPOSTGETPUTDELETE
CRUD OPCREATEREADUPDATEDELETE
/dogsCreate new dogsList dogsBulk updateDelete all dogs
/dogs/1234ErrorShow BoIf exists, update Bo; If not, errorDelete Bo


"tags": [
  {"id": "125", "name": "Environment"},
  {"id": "834", "name": "Water Quality"}
],

and not 

"tags": [
  {"125": "Environment"},
  {"834": "Water Quality"}
],

Record Limits:

{
    "metadata": {
        "resultset": {
            "count": 227,
            "offset": 25,
            "limit": 25
        }
    },
    "results": []
}