ionwg / ion-doc

Ion Documentation
49 stars 10 forks source link

Codify HTTP interaction #29

Open lhazlewood opened 7 years ago

lhazlewood commented 7 years ago

Codify protocol semantics regarding HTTP link traversal for both getting resources and sending data to resource locations.

We should address:

boriseetgerink commented 1 year ago

Ion has the method member to specify the HTTP method to use: 7.5. method. The method member can be used in a form (6. Forms). This allows you to specify which endpoint and HTTP method to use to submit a JSON document to: 6.5. Form Submission. To me this is enough for HATEOAS and handles the first two points of your question.

HTTP header support could be added to the spec, but what value would that add?

Edit: For example, JSON:API codifies HTTP semantics in the media type, but that makes the implementation too restrictive, in my opinion. I like that Ion doesn't subscribe HTTP semantics.