Il formato di file Swagger, ora formalmente noto come OpenAPI Specification (OAS), è un linguaggio di descrizione dell'interfaccia leggibile dalle macchine, utilizzato per descrivere, produrre, consumare e visualizzare servizi web RESTful. Creato originariamente da SmartBear Software, consente agli sviluppatori di definire l'intera struttura di un'API, inclusi endpoint disponibili, parametri delle operazioni, metodi di autenticazione e schemi di risposta. Utilizzando un formato standardizzato, i file Swagger permettono la generazione automatizzata della documentazione, la creazione di librerie client in vari linguaggi di programmazione e il testing automatizzato. Il formato è solitamente scritto in JSON o YAML, rendendolo sia leggibile dagli esseri umani che facilmente analizzabile dalle macchine. Funge da progetto (blueprint) per l'API, garantendo che sia il team frontend che quello backend abbiano una comprensione chiara e condivisa di come il servizio debba comportarsi. Ciò riduce gli errori di integrazione e accelera il ciclo di vita dello sviluppo fornendo un approccio 'contract-first' alla progettazione delle API. È ampiamente adottato nell'industria del software come standard per la documentazione e la progettazione di API RESTful, supportato da un vasto ecosistema di strumenti per il testing, il mocking e il deployment.