Hypermedia API with "form"-like descriptions

budgets.json

{
   "_links":{
      "add":{
         "title":"Add Budget",
         "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets",
         "method":"post",
         "parameters":{
            "name":{
               "type":"string",
               "required":true
            },
            "amount":{
               "type":"float",
               "required":true,
               "length":"10,2"
            }
         }
      }
   },
   "items":[
      {
         "id":73,
         "name":"Stroopwafels",
         "amount":120,
         "balance":70,
         "_links":{
            "self":{
               "rel":"budget",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/73",
               "method":"get"
            },
            "delete":{
               "title":"Delete",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/73",
               "method":"delete"
            },
            "transactions":{
               "title":"Transactions",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/73\/transactions",
               "method":"get"
            },
            "add_transaction":{
               "title":"Add Transaction",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/73\/transactions",
               "method":"post",
               "parameters":{
                  "name":{
                     "type":"string",
                     "required":true
                  },
                  "amount":{
                     "type":"float",
                     "required":true,
                     "length":"10,2"
                  }
               }
            }
         }
      },
      {
         "id":74,
         "name":"Souvenirs ",
         "amount":200,
         "balance":200,
         "_links":{
            "self":{
               "rel":"budget",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/74",
               "method":"get"
            },
            "delete":{
               "title":"Delete",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/74",
               "method":"delete"
            },
            "transactions":{
               "title":"Transactions",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/74\/transactions",
               "method":"get"
            },
            "add_transaction":{
               "title":"Add Transaction",
               "href":"http:\/\/localhost\/brightb.it\/budgetapp\/budgets\/74\/transactions",
               "method":"post",
               "parameters":{
                  "name":{
                     "type":"string",
                     "required":true
                  },
                  "amount":{
                     "type":"float",
                     "required":true,
                     "length":"10,2"
                  }
               }
            }
         }
      }
   ]
}

Hey, this is quite interesting - I've also been doing some similar sketching to add something form-like on top of HAL:

https://gist.github.com/893552