取消重签接口

取消一笔进行中的重签请求，将证书恢复到重签前的状态。

取消成功后：若证书此前已有签发记录，将恢复上一张已签发证书（ca_status 回到 issued）；若是首次申请的重签，则回退到待提交状态（ca_status 为 awating_csr）。

获取API&Keys

接口地址

POST /api/v1/certificate/abort-reissue

Host: 
...

完整地址

/api/v1/certificate/abort-reissue

请求

Content-Type: application/json

{
  "service_id": "o91bZ" // 证书编号，必填，下单时候返回的 `service_id`
}

响应

response

HTTP/1.1 200 OK

Content-Type: application/json

{
  "success": true,
  "data": {
    "service_id": "o91bZ", // 与请求传入的证书编号一致，回显的键名与请求参数名相同
    "status": "issued", // 证书状态
    "ca_status": "issued", // CA 侧状态：有历史签发记录时为 `issued`，首次申请则回退为 `awating_csr`
    "message": "Reissue request cancelled successfully"
  }
}

errors

HTTP/1.1 404 Not Found

Content-Type: application/json

{
  "success": false,
  "message": "The certificate is not found, or has been cancelled or refunded"
}

HTTP/1.1 422 Unprocessable Content

Content-Type: application/json

{
  "success": false,
  "message": "证书已处于签发状态，无需放弃重签"
}

错误码

HTTP 状态码	message	含义与处理建议
400	Order is manually locked, aborting reissue is not supported	订单被人工锁定，不支持取消重签，联系客服处理
400	Certificate submission is pending, please try again later	证书正在提交至 CA，稍后重试
400	CA 返回的错误信息	取消 CA 侧重签失败，按 message 内容排查；没有有效信息时请联系客服
404	The certificate is not found, or has been cancelled or refunded	证书不存在、已取消或已退款，或不属于当前 API 密钥对应的工作空间
422	证书已处于签发状态，无需放弃重签	证书不在重签流程中，无需取消
422	证书已吊销，无法放弃重签	证书已吊销，无法取消重签
422	证书尚未提交，无需放弃重签	证书尚未提交至 CA，无需取消
422	未找到可恢复的历史签发记录	数据异常，联系客服处理
422	参数校验信息	未提供证书编号，或编号无法解析；响应同时带 errors 明细

422 的响应体带 errors 明细

参数校验失败（422）时，除了 message 外还会返回 errors 字段，标明是哪个参数不合法：

{
  "success": false,
  "message": "The service ID is required",
  "errors": {
    "service_id": ["The service ID is required"]
  }
}

前置条件

调用前请确认以下条件全部满足，否则会被拒绝：

1. 证书当前 ca_status 为 pending，即重签请求正在处理中
2. 订单未被人工锁定
3. 证书不在提交队列中（submit_pending 为否）
4. 证书属于当前 API 密钥对应的工作空间

如需重新发起重签，请使用证书重签接口。