Suggest error codes - Githubissues

interagent / http-api-design

HTTP API design guide extracted from work on the Heroku Platform API

https://geemus.gitbooks.io/http-api-design/content/en/

Other

13.69k stars 1.07k forks source link

Suggest error codes #34

Closed rstacruz closed 10 years ago

rstacruz commented 10 years ago

I think there should be a list of common error statuses and when to use them. Right now there's only a prescribed 401 for unauthenticated users, and 406 for users without permissions.

It'd be nice to have something like:

429 Too many requests - for rate limiting APIs
422 Unprocessable entity - for POST/PUT validation errors
500 Internal server error - for errors that are your backend's fault

geemus commented 10 years ago

I've added those, let me know what you think. Thanks!

rstacruz commented 10 years ago

Looking swell! Thanks for all the work you've put into this document, you're doing the web development world a great service.

geemus commented 10 years ago

Thanks, I appreciate the support!

rhoberman commented 10 years ago

Can I second that? I'm busy gearing up for an http-api project and I'm finding this project extremely useful.

Richard

On 8 July 2014 15:12, Wesley Beary notifications@github.com wrote:

Thanks, I appreciate the support!

— Reply to this email directly or view it on GitHub https://github.com/interagent/http-api-design/issues/34#issuecomment-48341077 .

geemus commented 10 years ago

@rhoberman thanks, glad to hear it! Definitely welcome your feedback and look forward to seeing what you come up with.