|
| 1 | +# Web API design |
| 2 | + |
| 3 | +## API design articles and guidelines |
| 4 | + |
| 5 | +- [API Design Guide](https://apiguide.readthedocs.io/en/latest/) |
| 6 | + – detailed explanation of API design principles (en). |
| 7 | +- [HTTP API Design Guide](https://github.com/interagent/http-api-design/tree/master/en) |
| 8 | + – set of API design principles, extracted from Heroku API (en). |
| 9 | + |
| 10 | +## REST API tutorials and guides |
| 11 | + |
| 12 | +- [REST API: Your Guide to Getting Started Quickly](https://stackify.com/rest-api-tutorial/) |
| 13 | + – REST tutorial with Docker and Swagger (en). |
| 14 | +- [REST Resource Naming Guide](https://restfulapi.net/resource-naming/) |
| 15 | + – big guide on REST API naming. Whole website worth reading (en). |
| 16 | +- [REST CookBook](http://restcookbook.com/) |
| 17 | + – set of problems&solutins for REST API (en). |
| 18 | + |
| 19 | +## API guidelines |
| 20 | + |
| 21 | +- [Microsoft API guidelines](https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md) |
| 22 | + – Microsoft's internal company-wide REST API design guidelines (en). |
| 23 | +- [Design Guidelines](http://apistylebook.com/design/guidelines/) |
| 24 | + – set of API guidelines of different companies (en). |
| 25 | +- [Zalando RESTful API and Event Scheme Guidelines](https://opensource.zalando.com/restful-api-guidelines/index.html) |
| 26 | + – API guidelines from Zalando (en). |
| 27 | +- [Google API Design Guide](http://apistylebook.com/design/guidelines/google-api-design-guide) |
| 28 | + – Google API guidelines (en). |
| 29 | +- [NationalBankBelgium/REST-API-Design-Guide](https://github.com/NationalBankBelgium/REST-API-Design-Guide/wiki) |
| 30 | + – REST API Design Guide of the National Bank of Belgium (en). |
| 31 | +- [VictorianGovernment/api-design-standards](https://github.com/VictorianGovernment/api-design-standards/blob/master/api-standards.md) |
| 32 | + – Design Standards for Whole of Victorian Government Application Programming Interfaces (en). |
| 33 | + |
| 34 | +## Nice API examples |
| 35 | + |
| 36 | +- [Slack Web API](https://api.slack.com/web). |
| 37 | +- [Gitlab API Docs](https://docs.gitlab.com/ee/api/). |
0 commit comments