Estou nos estágios iniciais do planejamento de uma API REST e gostaria que ela aderisse à restrição HATEOAS de REST. Mas eu também gostaria de fornecer um formato JSON. Então, minha pergunta é se existem convenções por aí para representar links e formulários no JSON.

Eu encontrei exemplos de links, e parece que essa é uma maneira bastante comum de representar links:

"links": [ 
{"rel": "self", "href":"http://example.org/entity/1"},
{"rel": "friends", "href":"http://example.org/entity/1/friends"}] 

Representar formulários, por outro lado, não é algo que eu tenha visto muito. Eu estava pensando que talvez alguém tenha se sentado e pensado em algo nesse sentido, mas considerou todas as ressalvas:

"forms" : [
{"rel" : "new client", "action" : "/clients", "method": "post", 
"fields" : ["name":"string", "zipcode":"int", "signedup":"date", "state": ["Alabama",...]...]}]

A inspiração para isso vem de olhar para este vídeo, onde Jon Moore sugere que o JSON não é um bom formato para uma hipermídia api:

http://oredev.org/2010/sessions/hypermedia-apis

Uma conversa muito boa pelo caminho!

Toda entrada é apreciada!