Requires the license info in your API descriptions.
| OAS | Compatibility |
|---|---|
| 2.0 | ✅ |
| 3.0 | ✅ |
| 3.1 | ✅ |
| 3.2 | ✅ |
The principle of providing your users with accurate and relevant information does not apply to API design only, but to any product-related communication in general.
Before they can work with your API, your users must understand the terms and conditions of your API usage.
By being upfront with the API license, you can reduce friction and encourage API adoption.
| Option | Type | Description |
|---|---|---|
| severity | string | Possible values: off, warn, error. Default warn (in recommended configuration). |
An example configuration:
rules:
info-license: errorGiven the following configuration:
rules:
info-license: errorExample of an incorrect license:
info:
version: v1.1Example of a correct license:
info:
license:
name: Apache 2.0