API Evangelist API Evangelist
API Learnings
Toolbox
API Evangelist LLC

Names for APIs.json Contracts

Providing a clear, descriptive, and concise name for each API contract, as well as the APIs it contains, properly defining the scope.

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 needs their own specific names, the name in the APIs.json ...

Strategies

APIs are Defined as API Contracts

I think of API contracts as the thing that bridges the business and technology sides of what we do. When you define APIs as contracts and manage them in source control, you can track not just the t...