mirror of
https://github.com/adidas/api-guidelines.git
synced 2025-10-25 15:19:19 +00:00
13 lines
833 B
Markdown
13 lines
833 B
Markdown
# API Design Platform
|
|
|
|
1. [Apiary](https://apiary.io/) is the primary platform supporting [API first approach](../../general-guidelines/api-first.md). Apiary **MUST** be used during API Design.
|
|
2. Every API description **MUST** be stored in [Apiary](https://apiary.io/) under the ADIDAS team.
|
|
3. Apiary **MUST** be the **single source of truth** to learn about existing APIs within the organization.
|
|
|
|
> NOTE: Apiary supports API-first approach in multiple ways:
|
|
> a. Validates API description for correctness and automatically generates API documentation to drive the discussion between stakeholders. \(No more emails with API description flying between stakeholders\)
|
|
>
|
|
> NOTE: The synchronization between the version control system and adidas [API Description platform](apiary.md)
|
|
> should be automated using CI/CD framework.
|
|
|