Zalando Tech team (German electronic commerce company) has created comprehensive set of guidelines and the best practices for API design for mutli-team development company.
Great RESTful APIs look like they were designed by a single team. This promotes API adoption, reduces friction, and enables clients to use them properly. To build APIs that meet this standard, and to answer many common questions encountered along the way of RESTful API development.
It covers: design principles, security, compatibility, JSON guidelines, naming, resources, HTTP, performance, pagination, hypermedia, data formats and much more.
Really nice job, congrats to Zalando Team.
[Read More]