DNS 管理

DNS 服务商凭证管理。

📄️查询 DNS API 列表

分页查询 DNS 服务商凭据记录，按 ID 倒序返回。普通用户只能读取自己的记录并忽略 uid 筛选；管理员可用 uid 查询指定用户的记录。响应会直接返回数据库保存的 auth 文本，应避免在不可信环境展示或记录。

📄️创建 DNS 服务商凭据

创建用于证书 DNS 验证和网站 DNS 操作的服务商凭据。默认归属当前登录用户；管理员可通过 uid 为指定用户创建。每种服务商类型要求不同的 auth 键。服务端将 DNS.COM 列入可选类型但没有额外的 auth 键校验，仍需提供非空对象。

📄️删除一个或多个 DNS 服务商凭据

按路径中的 DNS API ID 删除凭据。支持以英文逗号传入多个 ID；普通用户只能删除自己的记录，管理员可删除其他用户记录。任一记录无效、被证书或网站引用、被设置为证书默认 DNS API 时均拒绝删除并回滚本次事务。

📄️获取自己的 DNS 服务商凭据详情

按 ID 读取当前登录用户自己创建的 DNS API 凭据。查询条件始终同时匹配 id 和当前用户 ID，因此管理员也不能通过该接口读取其他用户的详情；记录不存在或不归属当前用户时均返回 dnsapi-4。响应包含敏感 auth JSON 文本。

📄️更新 DNS 服务商凭据

更新指定 DNS API 凭据的已提交字段；路径 api_id 会覆盖请求体中的 id。普通用户只能更新自己的记录，管理员可以更新任意记录；管理员可额外传 uid 进行归属校验。所有业务字段可选，未提交字段保持原值，且没有实际变更时接口仍成功返回。若提交 auth，服务端按当前或提交后的 type 校验所需服务商键。