获取证书

开发环境

http://127.0.0.1:7001

POST

/api/v1/cert/get

根据域名或者证书id获取证书，当没有证书时可以自动创建流水线去申请新证书

授权说明：
header中传入x-certd-token即可调用开放接口
1、首先从OpenKey页面生成keyId，keySecret；
2、准备一个content( json字符串)： content={"keyId":keyId, t:时间戳秒数, encrypt:false, signType:"md5"} // encrypt返回结果是否加密
3、将content加上keySecret进行签名： sign = md5(content + keySecret)
4、然后将content和sign分别base64后用.号连接： x-certd-token = base64(content) +"."+base64(sign)

请求参数

Authorization

API Key

在 header 添加参数

x-certd-token

示例：

x-certd-token: ********************

Body 参数application/json

示例

{
    "domains": "project111.handsfree.work",
    "autoApply": true,
    "autoApplyTemplateId": 1,
    "autoApplyParams": {"renewDays": 23}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://127.0.0.1:7001/api/v1/cert/get' \
--header 'x-certd-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domains": "project111.handsfree.work",
    "autoApply": true,
    "autoApplyTemplateId": 1,
    "autoApplyParams": {"renewDays": 23}
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "data": {
        "crt": "string",
        "key": "string",
        "ic": "string",
        "oc": "string",
        "pfx": "string",
        "der": "string",
        "jks": "string",
        "one": "string",
        "p7b": "string",
        "detail": {
            "id": 0,
            "domains": [
                "string"
            ],
            "notAfter": 0
        }
    }
}

修改于 2026-08-08 14:35:26

Certd开放接口介绍

发送通知