在Linux上使用Swagger时，需要遵循一定的API规范要求，以确保API文档的清晰性、完整性和安全性。以下是一些关键要求：
规范格式：Swagger使用OpenAPI规范来描述RESTful API。规范通常以JSON或YAML格式编写，确保机器可读且易于理解。
模块化设计：API文档应按照功能模块化拆分，便于维护和更新。
版本控制：应在API路径中包含版本信息，例如/v1，以便于管理和区分不同版本的API。
参数校验：明确指定必填参数和数据类型，并在规范中进行详细描述。
安全机制：规范中应包含安全方案，如API密钥、OAuth等，以确保API的安全性。
动态文档：在运行时生成动态文档，以便用户可以实时查看和测试API。
监控和日志：实施监控和日志记录，以便跟踪API的使用情况和性能。
工具集成：使用Swagger工具集（如Swagger Editor、Swagger UI、Swagger Codegen等）来生成和维护API文档。
安全性测试：进行安全性测试，如使用Swagger EXP等工具进行API安全审计，以发现和修复潜在的安全漏洞。
遵守最佳实践：遵循Swagger和OpenAPI的最佳实践，包括使用组件来集中管理可重用的API部分，减少重复定义，使文档更加模块化和易于维护。
通过遵循这些要求，可以确保在Linux上使用Swagger时，API文档是清晰、完整且安全的，同时也便于开发者和用户的协作。