Settings

Theme

Ask HN: What are exemplary REST APIs?

1 points by jeroenheijmans 7 years ago · 2 comments · 1 min read


There are many good resources about writing APIs, but I'm also curious what the crowd here would consider great, exemplary REST API's? Looking for things like well-structured URI's, great design of request and response bodies, useful error handling, useful and beautiful documentation - as well as dealing with real-world stuff that can make API's and REST hard (pagination, wanting to do RPC style stuff specifically long-running tasks, etc.). Any good API's you'd recommend looking at for inspiration?

120bits 7 years ago

I have always liked stripe [1] API documentation. Its very well structured and does have a beautiful documentation.

[1]https://stripe.com/docs/api

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection