用途:在 REST API 设计中按 API 优先、契约优先方式编写和校验 OpenAPI 3.1 规范。适用于需要 OpenAPI Authoring 指导、规划或设计,以及希望遵循既有模式与标准的场景。
主要能力:覆盖根文档(openapi、info、servers、tags、paths、components、security);路径操作(get/post/put/patch/delete,含 operationId、summary、tags、parameters、requestBody、responses 与 Location 头等);可复用组件(请求/响应 schema、枚举、分页、HAL 风格链接、ErrorResponse 与 ValidationError 等问题详情结构);parameters 与 responses(BadRequest、Unauthorized、Forbidden、NotFound、Conflict、UnprocessableEntity、TooManyRequests 等,含 Retry-After 与限流响应头);安全方案(bearerAuth、apiKey、oauth2 授权码流);并给出与规范对应的 C# 模型示例。
限制:资料未提供安装命令、运行命令、平台、收费或价格信息,也未给出校验工具或具体使用步骤;上述内容需以实际项目与官方文档为准。