WhiteHouse / api-standards

3.08k stars 901 forks source link

Provide both request and response bodies for POST #29

Closed jrep closed 10 years ago

jrep commented 11 years ago

There is a body for both the request and the response of a POST. Only one of them is documented here (I think it's the request). Added response as well.

Also, did you really mean to limit POST to a single item? More usually it allows multiples, so I wrote it that way.

TravisCarden commented 10 years ago

Thank you, @jrep. I committed your changes to distinguish the request and response bodies and to make the POST example allow for multiple items. We're not prepared to specify or even recommend a POST response format, so I've omitted that for the time being. You're welcome to create an issue to discuss the question--especially if you have reasons to advocate for a particular approach. Thanks for your contribution!