# adidas Asynchronous API guidelines

## AsyncAPI guidelines for Kafka

### Servers

All AsyncAPI specs **MUST** include a servers section including references to the right Kafka clusters, defined and maintained by FDP team and made available through domains in Swaggerhub.

Those definitions are handled in Swaggerhub as reusable domains publicly available: 

https://design.api.3stripes.io/domains/adidas/asyncapi_adoption_commons/1.0.0

that can be referred from any spec, picking the right kafka servers as required (see example below).

```yaml
...
servers:
  pivotalDev:
    $ref: https://design.api.3stripes.io/v1/domains/adidas/asyncapi_adoption_commons/1.0.0#/components/servers/pivotalDev
  pivotalSit:
    $ref: https://design.api.3stripes.io/v1/domains/adidas/asyncapi_adoption_commons/1.0.0#/components/servers/pivotalSit
  pivotalPro:
    $ref: https://design.api.3stripes.io/v1/domains/adidas/asyncapi_adoption_commons/1.0.0#/components/servers/pivotalPro
...
```
**Important note** Don't forget to include '*/v1/*' in the URL of the domain