Questions to Ask

### Giai đoạn: Nền Tảng & Khái Niệm Cốt Lõi **Questions to Ask** - API as small as possible, as large as needed? - Is there one way of doing one thing, not multiple ones? - Is it consistent, does it follow the principle of least surprise? - Clean split of API/internals without internals leaking into the API? - Are there no breaking changes to user-facing parts (API classes, configuration, metrics, log formats, etc)? - Is a new API generally useful and not overly specific to a single use case? Learn more from the following resources: - [@article@API Design Best Practices Guide - Fern](https://buildwithfern.com/post/api-design-best-practices-guide) - [@article@RESTful API Resource Naming](https://restfulapi.net/resource-naming/) - [@article@Web API Design Best Practices - Microsoft Azure](https://learn.microsoft.com/en-us/azure/architecture/best-practices/api-design) ### Khái niệm cốt lõi: 1. **- API as small as possible, as large as needed** 2. **- Is there one way of doing one thing, not multiple ones** 3. **- Is it consistent, does it follow the principle of least surprise**