Providing a valid URL to a landing page for the API that is designed for humans to use when learning more about an API.
Human URL for APIs.json Contract
Rules
APIs.json APIs Human URL Info
The humanURL property for each API defined in an APIs.json contract provides a link for business or technical consumers to learn more about the API. This URL can direct users to a portal, documenta...
Strategies
APIs Have One Click Access
The front door to your API should always be one click away. A human URL for people to follow and a base path URL for machines to call. Put them in every artifact, every document, every conversation...
Experiences
Onboarding
I see teams dealing with massive friction during onboarding. If a consumer can't get from zero to their first successful API call in minutes, you've already lost them. Getting started guides, sandb...
Access
I keep seeing teams struggle with getting consumers proper access to their APIs. The sign-up, authentication, and authorization process is where you lose people before they ever make their first AP...