Re: [ietf-types] Review of application/vnd.error+xml and application/vnd.error+json

[Ben Longden <[e-mail]>]

Hi Jan,

Thanks for your comments.

> If I understand your intention correctly, these two media types are specifically designed to support the anti pattern of tunneling application specific semantics through HTTP.

I understand what you're saying... But I don't know how to respond to that. You could argue that point about any media type... How could you get application specific semantics from the server to the client without using HTTP? Even your example below is doing that. If you have a web api's then you *must* communicate using media types over HTTP. In the case of a web client, adopting this proposed standard means this is understood and disparate clients can understand the same message.

> The error communicated of an HTTP error response is specifically indicated by the HTTP status codes (4xx and 5xx). If you feel you need more specific error semantics, you are probably applying HTTP in the wrong way (as a transport to tunnel application semantics).

I am absolutely advocating the use of the HTTP status code - that's why I have excluded it from the proposed media type(s).

> From the POV of playing nice with Web architecture I suggest you think about designing proper resource semantics instead.
> 
> Regarding the name vnd.error... I think this is an incorrect naming pattern in the vnd-tree, please check.

There are approved examples of excluding the vendor name from the vnd tree, (http://www.amundsen.com/media-types/collection/) being one. I shall check this out though.

> Having said that, I think you can achieve pretty much the same with a combination of Link-headers and text/html or text/plain and content negotiation to handle the i18n issue. What do you think?

I'd argue that a JSON representation with embedded links (_links in application/vnd.error+json) is a lot easier for javascript (one of the main consumers of this media type) to parse than link headers. Totally agree with con-neg to handle the i18n issue and have dropped the multi-lang stuff from the spec.

If I just use text/plain then I run into problems when I want to represent anything other than just the message (i.e, the id), and then have a requirement for a media type that can represent it.

BenLongden
http://nocarrier.co.uk