Providing a clear, descriptive, and concise name for each API contract, as well as the APIs it contains, properly defining the scope.
Names for APIs.json Contracts
Rules
APIs.json Name Info
The name of a collection of APIs should describe their purpose, target audience, and the problems they aim to solve. While individual APIs should have their own specific names, the name in the APIs...
Lifecycle
description Definitions Define
The definition is the contract. OpenAPI, AsyncAPI, JSON Schema, and APIs.json are the machine-readable artifacts I use to describe what an API is before, during, and after it exists. Investing in s...
