Спецификация OpenAPI (OAS), ранее известная как спецификация Swagger, представляет собой общепризнанный мировой стандарт для определения и документирования RESTful API. Файл с расширением .openapi служит машинно-независимым описанием интерфейса, которое позволяет как людям, так и программным средствам обнаруживать и понимать возможности веб-сервиса без необходимости доступа к его исходному коду. Эти файлы обычно структурированы с использованием форматов YAML или JSON и содержат подробную информацию о конечных точках (endpoints) API, включая доступные операции, входные параметры, форматы выходных данных, требования к аутентификации и сведения о лицензировании. Используя этот формат, разработчики могут внедрять методологию проектирования «API-first», гарантируя, что интерфейс будет четко определен до написания какого-либо программного кода. Это значительно упрощает автоматизированную генерацию интерактивной документации, клиентских комплектов для разработки программного обеспечения (SDK), серверных заглушек и комплексных наборов тестов. Формат поддерживается организацией OpenAPI Initiative, консорциумом под эгидой Linux Foundation, и стал отраслевым стандартом для современной веб-разработки, обеспечивая бесшовную интеграцию между разрозненными системами и улучшая взаимодействие между командами фронтенд- и бэкенд-инженеров.