申请签发证书（免费）

POST

/ssl/certificates

签名为异步任务，申请成功时 status 通常为 pending，需通过查询接口轮询至 active 或 awaiting_dns 后方可部署。

校验固定使用 DNS-01。多域名可分别托管在不同 DNS 服务商：通过 domain_bindings 逐域名指定校验方式（auto 自动匹配解析账号 / manual 手工添加解析记录 / account:<解析账号ID> 指定账号）；未匹配到解析账号的域名不会报错，会自动转入手工校验（status=awaiting_dns），此时按响应中的 dns_records 到对应服务商添加 TXT 记录后调用 POST /ssl/certificates/verify 继续签发。

请求参数

Query 参数

Body 参数application/x-www-form-urlencoded必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://yun.jxhcyun.com/api/ssl/certificates?app_id=APPID&app_key=APPKEY' \
--data-urlencode 'domain=example.com' \
--data-urlencode 'domains=www.example.com,api.example.com' \
--data-urlencode 'domain_bindings=' \
--data-urlencode 'dns_account_id=1' \
--data-urlencode 'driver=' \
--data-urlencode 'auto_renew=true'

返回响应

🟢200

application/json

统一返回（HTTP 状态恒为 200）

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "cert_no": "CERTa1b2c3d4",
        "domain": "example.com",
        "domains": [
            "example.com",
            "www.example.com"
        ],
        "dns_account_id": 0,
        "status": "pending",
        "status_text": "已生效",
        "driver": "letsencrypt",
        "challenge_type": "dns-01",
        "expires_at": "2027-01-09 00:00:00",
        "dns_bindings": {
            "property1": {
                "mode": "auto",
                "account_id": 0
            },
            "property2": {
                "mode": "auto",
                "account_id": 0
            }
        },
        "dns_records": [
            {
                "domain": "string",
                "type": "string",
                "name": "string",
                "value": "string"
            }
        ]
    }
}

修改于 2026-10-16 22:06:45

手工解析完成后继续校验与签发

查询证书