跳到正文
Navigation

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

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

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

Request body application/x-www-form-urlencoded required

  • request_time
    string
    required

    Unix 时间戳。

  • request_token
    string
    required

    按 API 概览生成的签名。

  • action
    apply_dns_auth
    required

    具体操作名称。

  • index
    string
    required

    订单索引 ID(由 apply_cert_api 返回)

Returns

default

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

JSON
  • status
    optional
    boolean

    true 申请成功

  • msg
    optional
    string

    申请成功!

  • cert
    optional
    string

    完整证书链(PEM 格式)

  • private_key
    optional
    string

    私钥(PEM 格式)

  • domains
    optional
    array of
    unknown

    证书覆盖的域名列表

  • cert_timeout
    optional
    integer

    证书到期时间戳

各操作详细说明

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

自动调用已配置的 DNS 提供商 API(如腾讯云 DNSPod)创建 ACME 所需的 _acme-challenge TXT 记录,完成域名验证,签发并下载证书。验证完成后自动删除临时 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
}

相关接口

Type to search…

↑↓ navigate↵ selectEsc close