Example of a REST API convention

restAPI.txt

GET /persons [All persons data in a list]
{
  success: true,
  response: [personObject, personObject, personObject, personObject...]
}

GET /persons/1575  [returns a single person]
{
  success: true,
  response: {
    name: 'Eugene',
    age: 27,
    location: 'NY for now'
    ...
  } // personObject 
}

POST /persons [adds a new single person]
{
  success: true,
  response: personObject (with created_at timestamp of actual create time)
}

PATCH/PUT /persons/1575
{
  success: true,
  response: personUpdatedObject (with modified_at timestamp of actual update time)
}

DELETE /persons/1575
{
  success: true
}