API Evangelist API Evangelist
API Learnings
Toolbox
API Evangelist LLC

Names for APIs

Providing a clear, descriptive, and concise name for each API, as well as the APIs it contains, properly defining the scope, with an intuitive first impression of an API.

Rules

APIs.json APIs Name Info

Each individual API in an APIs.json collection has its own name property, allowing for a clear description of the API. This name might match the API's title in the OpenAPI Info section, but it coul...

Strategies

APIs Are Discoverable Through a Central Catalog

If people can't find your APIs, they will build their own--and that is how duplication spirals out of control. A central catalog with consistent metadata, tags, and descriptions is one of the most ...