O formato de arquivo Swagger, agora formalmente conhecido como OpenAPI Specification (OAS), é uma linguagem de descrição de interface legível por máquina para descrever, produzir, consumir e visualizar serviços web RESTful. Originalmente criado pela SmartBear Software, ele permite que desenvolvedores definam toda a estrutura de uma API, incluindo endpoints disponíveis, parâmetros de operação, métodos de autenticação e esquemas de resposta. Ao utilizar um formato padronizado, os arquivos Swagger permitem a geração automatizada de documentação, criação de bibliotecas de cliente em várias linguagens de programação e testes automatizados. O formato é tipicamente escrito em JSON ou YAML, tornando-o legível por humanos e fácil de analisar por máquinas. Ele serve como um projeto (blueprint) para a API, garantindo que as equipes de frontend e backend tenham uma compreensão clara e compartilhada de como o serviço deve se comportar. Isso reduz erros de integração e acelera o ciclo de vida de desenvolvimento ao fornecer uma abordagem de design de API 'contract-first' (contrato primeiro). É amplamente adotado na indústria de software como o padrão para documentação e design de APIs RESTful, suportado por um vasto ecossistema de ferramentas para testes, mocking e implantação.