A Especificação OpenAPI (OAS), anteriormente conhecida como Especificação Swagger, é um padrão reconhecido globalmente para definir e documentar APIs RESTful. Um arquivo .openapi atua como uma descrição de interface agnóstica de linguagem, permitindo que humanos e máquinas descubram e compreendam as capacidades de um serviço web sem a necessidade de acesso ao código-fonte subjacente. Esses arquivos são geralmente estruturados usando YAML ou JSON e contêm informações detalhadas sobre os endpoints da API, incluindo operações disponíveis, parâmetros de entrada, formatos de saída, requisitos de autenticação e informações de licenciamento. Ao utilizar este formato, os desenvolvedores podem implementar uma metodologia de design 'API-first', garantindo que a interface seja claramente definida antes que qualquer código seja escrito. Isso facilita a geração automatizada de documentação interativa, kits de desenvolvimento de software (SDKs) para o lado do cliente, stubs de servidor e conjuntos de testes abrangentes. O formato é mantido pela OpenAPI Initiative, um consórcio sob a Linux Foundation, e tornou-se o padrão da indústria para o desenvolvimento web moderno, permitindo uma integração perfeita entre sistemas distintos e melhorando a colaboração entre equipes de engenharia frontend e backend.