API Evangelist API Evangelist
API Learnings
APIs
API Governance
API Solutions
API Discovery
API Building Blocks
API Evangelist LLC

Getting Started

Keeping up with the latest versions of the specification.

A getting started page is a common and essential building blocks of modern public API providers. Providing a simple step by step overview of what it takes to get started with an API helps reduce friction for new consumers, and increase the number of successful API integrations.

A getting started page is just compiling other existing elements like documentation, sign-up, authentication, and SDKs, and organizing them in an intuitive list of steps API consumers can follow. Getting started should focus on everything API consumers will need to make their first call to an API.

Getting started pages help API consumers onboard, but it also helps API producers think through the complexity or simplicity of putting their APIs to work. Sometimes we are too close to an API to see the steps that are missing, and taking a moment to craft a getting started page can help us think through what is needed by our consumers.