API Specification

Noun · Development

Definitions

  1. A formal description of an API's operations, parameters, schemas, authentication, and expected responses, often written in a format such as OpenAPI. API specifications enable tooling such as code generation, validation, documentation, and contract testing.

    In plain English: A formal description of how an API works and what it expects.

    Example: "The team treated the OpenAPI file as the source of truth so the API specification, docs, and generated SDKs stayed aligned."

Related Terms