版本 2.1.1792967583 · 最新 下载 OpenAPI Markdown 版

DNS API(证书验证)

DNS 服务商的 API 凭据,用于 DNS-01 验证与签发通配证书。凭据只写,响应只回掩码。

dns-apis证书鉴权: 用户(部分参数仅管理员)5 个接口

列出DNS API 凭据

GET/api/v2/dns-apis
鉴权: 用户(部分参数仅管理员)

查询参数

字段类型必填说明
pageinteger— 页码,从 1 开始。
默认 1
page_sizeinteger— 每页条数。
默认 20
sortstring— 排序字段,逗号分隔,前缀 `-` 表示降序,如 `-created_at,id`。
tenant_idinteger— 仅管理员可用:按租户过滤。租户凭据调用时忽略,只返回本租户数据。

创建DNS API 凭据

POST/api/v2/dns-apis
鉴权: 用户(部分参数仅管理员)

查询参数

字段类型必填说明
tenant_idinteger— 仅管理员可用:按租户过滤。租户凭据调用时忽略,只返回本租户数据。

请求体 application/json

字段类型必填说明
authobject— 凭据键名 → 掩码(≥16 位露末 4 位 `****abcd`,否则 `********`),不回明文。
desstring— 备注说明
namestring必填 名称
typestring必填 DNS 服务商。

获取DNS API 凭据

GET/api/v2/dns-apis/{id}
鉴权: 用户(部分参数仅管理员)

修改DNS API 凭据

PUT/api/v2/dns-apis/{id}
鉴权: 用户(部分参数仅管理员)

请求体 application/json

字段类型必填说明
authobject— 凭据键名 → 掩码(≥16 位露末 4 位 `****abcd`,否则 `********`),不回明文。
desstring— 备注说明
namestring必填 名称
typestring必填 DNS 服务商。

删除DNS API 凭据

DELETE/api/v2/dns-apis/{id}
鉴权: 用户(部分参数仅管理员)

DNS API(证书验证)对象

字段类型必填说明
authobject— 凭据键名 → 掩码(≥16 位露末 4 位 `****abcd`,否则 `********`),不回明文。
created_atstring— 创建时间
只读
desstring— 备注说明
idinteger— 记录 ID
只读
namestring— 名称
tenant_idinteger— 所属租户(用户)ID
只读
typestring— DNS 服务商。
updated_atstring— 更新时间
只读