查询证书

GET

/ssl/certificates/query

按证书编号查询证书详情，响应 data 与「申请签发」一致；建议轮询间隔 3～10 秒。当 status=awaiting_dns 时，dns_records 返回需手工添加的 TXT 记录（含对应域名），到对应 DNS 服务商添加并生效后调用 POST /ssl/certificates/verify 继续签发。

请求参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://yun.jxhcyun.com/api/ssl/certificates/query?app_id=APPID&app_key=APPKEY&cert_no=CERTa1b2c3d4'

返回响应

🟢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

申请签发证书（免费）

下载证书内容