[ADE-22] API First
reviewing phase 1
This article needs more reference and practical content.
Overview
From github.com/ByteByteGoHq/system-design-101
API-first is essentially contract-first. The entire team collaborates from the outset to establish a contract. This allows frontend engineers, backend engineers, and test programmers to work independently on their implementations while adhering to the agreed-upon contract.
API First with ADP
When designing and reviewing APIs in an API-first approach, finding best practices or creating new ones from scratch can be time-consuming. By reading ADP and discussing it with your API reviewer, you can save time and ensure that your API design adheres to established standards and best practices.
Reference
Inspiring quotes for API
An API is a promise. source
An API is nice to be important, but more important to be nice. source
APIs
- shall be technically correct
- keep the promise to the clients and never break the contract
- should be respectful, courteous
- make contract more pleasant
- https://www.youtube.com/watch?v=twfufQn1mD0