创建部署任务

POST

/ssl/deploy

每个 target_ids[] 生成一个部署任务（1 个目标 = 1 点），任务为异步执行。

仅「已生效（active）」的证书可部署，否则返回「证书尚未生效，无法部署」。

target_ids 为空，或所选目标不存在 / 已停用 / 不属于当前账号时，返回 code: 0 +「请至少选择一个有效的部署目标（所选目标不存在、已停用或不属于当前账号）」。

amount 在部署成功后写入，创建时该字段为 null。

请求参数

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/deploy?app_id=APPID&app_key=APPKEY' \
--data-urlencode 'cert_no=CERTa1b2c3d4' \
--data-urlencode 'target_ids%5B%5D=' \
--data-urlencode 'target_ids%5B%5D='

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "count": 2,
        "tasks": [
            {
                "task_no": "TASKa1b2c3d4",
                "cert_no": "CERTa1b2c3d4",
                "target_id": 1,
                "status": "pending",
                "status_text": "部署成功",
                "amount": 1
            }
        ]
    }
}

修改于 2026-10-08 19:13:15

吊销证书

查询部署任务