Struct OpenApiBuilder 

pub struct OpenApiBuilder { /* private fields */ }

OpenAPI 规范构建器

对齐 OpenAPI 3.0.3 规范，通过链式 API 构建 spec。

Implementations

impl OpenApiBuilder

pub fn new(title: &str, version: &str) -> Self

创建新的构建器

参数

• title：API 标题
• version：API 版本

pub fn description(self, desc: &str) -> Self

设置 API 描述

pub fn tag(self, name: &str, description: &str) -> Self

添加标签（用于分组）

pub fn path<F>(self, path: &str, method: HttpMethod, config: F) -> Self

where F: FnOnce(&mut OperationBuilder),

添加 API 端点

参数

• path：路径（如 /api/v1/users/{id}）
• method：HTTP 方法
• config：操作配置闭包

pub fn bearer_auth(self, scheme_name: &str) -> Self

添加 Bearer Token 安全方案

pub fn api_key_auth(self, scheme_name: &str, header_name: &str) -> Self

添加 API Key 安全方案

pub fn build(self) -> Value

构建 OpenAPI spec（serde_json::Value）

pub fn to_json_string(self) -> String

构建 JSON 字符串（美化格式）