Code First v.s. API First - A change of software development philosophy.
The diagram below shows the differences between code-first development and API-first development. Why do we want to consider API first design?
1 of 10
The diagram below shows the differences between code-first development and API-first development. Why do we want to consider API first design?
1 of 10
🔹Microservices increase system complexity
We have separate services to serve different functions of the system. While this kind of architecture facilitates decoupling and segregation of duty, we need to handle the various communications among services.
2 of 10
We have separate services to serve different functions of the system. While this kind of architecture facilitates decoupling and segregation of duty, we need to handle the various communications among services.
2 of 10
It is better to think through the system's complexity before writing the code and carefully defining the boundaries of the services.
3 of 10
3 of 10
🔹Separate functional teams need to speak the same language
The dedicated functional teams are only responsible for their own components and services. It is recommended that the organization speak the same language via API design.
4 of 10
The dedicated functional teams are only responsible for their own components and services. It is recommended that the organization speak the same language via API design.
4 of 10
🔹Improve software quality and developer productivity
Since we have ironed out most of the uncertainties when the project starts, the overall development process is smoother, and the software quality is greatly improved.
5 of 10
Since we have ironed out most of the uncertainties when the project starts, the overall development process is smoother, and the software quality is greatly improved.
5 of 10
Developers are happy about the process as well because they can focus on functional development instead of negotiating sudden changes.
The possibility of having surprises toward the end of the project lifecycle is reduced.
6 of 10
The possibility of having surprises toward the end of the project lifecycle is reduced.
6 of 10
Because we have designed the API first, the tests can be designed while the code is being developed. In a way, we also have TDD (Test Driven Design) when using API first development.
7 of 10
7 of 10
👉 Over to you: Do you use code-first or API-first development in your work?
8 of 10
8 of 10
Good read: postman.com
9 of 10
9 of 10
I hope you've found this thread helpful.
Follow me @alexxubyte for more.
Like/Retweet the first tweet below if you can:
10 of 10
Follow me @alexxubyte for more.
Like/Retweet the first tweet below if you can:
10 of 10
Loading suggestions...