What comes back from the server once you POST a comment via the CommentAPI? That’s the question. Right now the specification says that the only required response is the HTTP status code. Currently there are two differing implementations. One returns a result code of 303 with a Location: header that points to a new URL. Another returns the number of comments for that item.
Any other implementations I am missing?
Any suggestions on how this should work?
You know, specification writing is hard. I just finished a very enlightenting conversation with someone on the RESTLog API that made me realize how much better that specification needs to be. So I am taking some time to read some RFC’s, some of the classics and some of the newer ones. Hopefully I can re-write the specs in a much clearer format that will ease implementation problems.