通过已配置的 DNS API 自动创建 TXT 验证记录，完成域名验证并签发证书

自动调用已配置的 DNS 提供商 API（如腾讯云 DNSPod）创建 ACME 所需的 _acme-challenge TXT 记录，完成域名验证，签发并下载证书。验证完成后自动删除临时 TXT 记录。

POST

https://your-panel.example.com:8888/acme

更新于 2026年7月10日查看 Markdown

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionapply_dns_authrequired
具体操作名称。
indexstringrequired
订单索引 ID（由 apply_cert_api 返回）

Returns

default

接口响应，业务状态见下方详细说明。

JSON

statusoptionalboolean
true 申请成功
msgoptionalstring
申请成功!
certoptionalstring
完整证书链（PEM 格式）
private_keyoptionalstring
私钥（PEM 格式）
domainsoptionalarray ofunknown
证书覆盖的域名列表
cert_timeoutoptionalinteger
证书到期时间戳

各操作详细说明

apply_dns_authaction=apply_dns_auth通过已配置的 DNS API 自动创建 TXT 验证记录，完成域名验证并签发证书

前置条件：已通过 /ssl/dnsapi/add_dns_data 配置 DNS API 密钥，并通过 /ssl/data/add_domain 添加域名。

路由：POST /acme
action：apply_dns_auth

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `apply_dns_auth`
index	是	String	订单索引 ID（由 `apply_cert_api` 返回）

输出参数

参数名称	类型	描述
status	Boolean	`true` 申请成功
msg	String	`申请成功!`
cert	String	完整证书链（PEM 格式）
private_key	String	私钥（PEM 格式）
domains	Array	证书覆盖的域名列表
cert_timeout	Integer	证书到期时间戳

示例

请求

POST /acme HTTP/1.1
Host: 192.168.168.213:8888
Content-Type: application/x-www-form-urlencoded

action=apply_dns_auth&index=a7a0472c4a5061ec83450119b874a5d3

响应

{
  "status": true,
  "msg": "申请成功!",
  "cert": "-----BEGIN CERTIFICATE-----\nMIIE7TCCA9W...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...",
  "domains": ["dnstest.cc"],
  "cert_timeout": 1780111135
}