Я нахожусь на ранних стадиях планирования API REST, и я хотел бы, чтобы он придерживался ограничения HATEOAS REST. Но я также хотел бы предоставить формат JSON. Поэтому мой вопрос: существуют ли соглашения для представления ссылок и форм в JSON.

Я нашел примеры ссылок, и похоже, что это довольно распространенный способ представления ссылок:

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

Представление форм с другой стороны, это не то, что я видел много. Я думал, что, возможно, кто-то сел и придумал что-то в этом духе, но учел все предостережения:

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

Вдохновением для этого является просмотр этого видео, где Джон Мур предполагает, что JSON не является хорошим форматом для гипермедиа API:

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

Кстати, очень хороший разговор!

Весь вклад приветствуется!