search

WhiteHouse / api-standards

3.08k stars 902 forks source link

Consider using the IETF API-Problem specification for error messages #37

Open cpliakas opened 10 years ago

cpliakas commented 10 years ago

Referring to the https://github.com/WhiteHouse/api-standards#error-handling section, it is great that the WH API standards promote helpful error messages for developers who consume the APIs. Have you considered adopting the IETF API-Problem specification? It appears to be similar in goals to what WH is trying to do, but it might be good to adopt a standard response format. There is a relevant blog post at http://www.mnot.net/blog/2013/05/15/http_problem, and there is some PHP tooling around the spec at https://github.com/Crell/ApiProblem.

Thanks! Chris

bryanhirsch commented 10 years ago

Thanks for this great suggestion @cpliakas. We'll take a look.