Latest Post:

What is an API?

Definition

An application programming interface (API) defines how software can interact with a service. For example, an app might request customer records, create an invoice or retrieve a query result through an API.

Each API has its own operations, request formats, limits and access requirements. An API key is one possible access mechanism; other APIs use approaches such as OAuth.

Why it matters

An API can make a repeated task part of an existing workflow. A team might create a workspace as part of onboarding, retrieve a saved report for another application or connect operational data without a manual export. The practical question is which operations the interface supports and how safely they can be repeated.

When assessing an API, look beyond the existence of documentation:

  • Check authentication, permission scopes and how access is revoked.
  • Understand pagination, rate limits and error responses.
  • Establish how retries avoid creating duplicate work.
  • Check whether changes to the API are versioned and communicated.

A small, dependable set of operations can be more useful than broad coverage with unclear behaviour when something fails.