Gist REST Json API

jsonapi.txt

// creation flow

POST /api/actors

{
   "data" : {
      "type": "actors",
      "attributes": {
        "type":   "threashold",
        "params": {
          "threashold": 2.5
        }
      },
      "links" : {
        "trigger": {
          "linkage" : { "type": "actors", "id":"9"}
        }
      }
    }
  }

 // read
 // meta and id generated server side
GET /api/actors/12

{
   "data" : {
      "type": "actors",
      "id": "12"
      "attributes": {
        "type":   "threashold",
        "params": {
          "threashold": 2.5
        }
      },
      "links" : {
        "trigger": {
          "linkage" : { "type": "actors", "id":"9", "meta": "http://coral.io/api/actors/9" }
        }
      }
    }
  }
  

// full modify

POST/PUT /api/actors/12

{
   "data" : {
      "type": "actors",
      "id": "12"
      "attributes": {
        "type":   "threashold",
        "params": {
          "threashold": 2.5
        }
      },
      "links" : {
        "trigger": {
          "linkage" : { "type": "actors", "id":"5" }
        }
      }
    }
  }
  
// partial modify the resource
PATCH /api/actors/12

{
   "data" : {
      "attributes": {
        "params": {
          "threashold": 3.5
        }
      }
    }
  }
  
// modify the trigger
PATCH /api/actors/12

{
   "data" : {
      "links" : {
        "trigger": {
          "linkage" : { "type": "actors", "id":"7" }
        }
      }
    }
  }