Siren example.

a.json

{
  "class": ["customer", "vip"],
  "properties": {
    "name": "Howard Duck",
    "title": "Mr."
  },
  "entities": [
    {
      "rel": ["http://example.com/rels/recent-orders"],
      "class": ["order-list"],
      "properties": {
        "count": 5
      },
      "links": [
        {
          "rel": ["self"],
          "href": "http://api.example.com/orders/recent?customer=1234"
        }
      ]
    }
  ],
  "actions": [
    {
      "name": "deactivate",
      "method": "POST",
      "href": "http://api.example.com/customer-activations",
      "fields": [
        { "name": "action", "type": "hidden", "value": "deactivate" },
        { "name": "id", "type": "hidden", "value": "1234" }
      ]
    }
  ],
  "links": [
    {
      "rel": ["self"],
      "href": "http://api.example.com/customers/1234"
    }
  ]
}