Best Practices: API Design [Part 2]

Well designed APIs = Happy Developers! 😃

Photo sourced from Pexels.com

[Part 1 — Best Practices: API Design]

API’s are great. They let you establish a channel to communicate between two systems which may be built on different platforms & let you send-receive data between them.

API design is an interesting part of software engineering & definitely an extremely important one. Well designed & documented APIs can be like a godsend when you want to integrate & communicate with a service from your app. In Part 1 of this article, we saw what APIs are & why should we use them.

We also learned about some best practices of API design such as

1. API data modeling & structuring
2. Writing resource-oriented APIs
3. Understanding the REST framework
4. API Versioning
5. Pagination

Good API Design is not limited to these best practices, but it also involves understanding your target audience, thinking from their perspective & incorporating elements that can make your API as easy to use without causing too many problems to the developers.

Return well-formatted JSON Responses