Swagger 文件格式，现正式称为 OpenAPI 规范 (OAS)，是一种用于描述、生成、消费和可视化 RESTful Web 服务的机器可读接口描述语言。它最初由 SmartBear Software 创建，允许开发人员定义 API 的完整结构，包括可用的端点 (endpoints)、操作参数、身份验证方法和响应架构 (response schemas)。通过使用标准化格式，Swagger 文件能够实现自动化的文档生成、多种编程语言的客户端库创建以及自动化测试。该格式通常以 JSON 或 YAML 编写，使其既具有人类可读性，又易于机器解析。它作为 API 的蓝图，确保前端和后端团队对服务的行为方式有清晰、共享的理解。这减少了集成错误，并通过提供“契约优先” (contract-first) 的 API 设计方法加速了开发生命周期。它在软件行业被广泛采用，作为 RESTful API 文档和设计的标准，并拥有庞大的工具生态系统支持，用于测试、模拟 (mocking) 和部署。