A comprehensive skill for designing, documenting, and implementing APIs that developers love to use. Covers REST, GraphQL, and hybrid approaches with emphasis on consistency, discoverability, and maintainability.
Define the API contract before implementation. This enables parallel development, clearer communication, and better documentation.
APIs should be predictable. Developers should be able to guess how an endpoint works based on patterns established elsewhere in the API.
Шаблоны проектирования API REST и GraphQL, спецификации OpenAPI/Swagger, стратегии управления версиями и шаблоны аутентификации. Используйте при разработке API, проверке контрактов API, оценке технологий API или реализации конечных точек API. Охватывает проектирование на основе контракта, моделирование ресурсов, обработку ошибок, нумерацию страниц и безопасность. Источник: rsmdt/the-startup.