From b4c362da37b49db8d9df23e3ba66f7c538b9282e Mon Sep 17 00:00:00 2001 From: xiaojunnuo Date: Tue, 25 Nov 2025 09:12:35 +0800 Subject: [PATCH] docs: openapi --- docs/guide/open/index.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/guide/open/index.md b/docs/guide/open/index.md index b393a3628..f0a2b4c1f 100644 --- a/docs/guide/open/index.md +++ b/docs/guide/open/index.md @@ -19,9 +19,15 @@ header中传入x-certd-token即可调用开放接口 4、然后将content和sign分别base64后用.号连接: x-certd-token = base64(content) +"."+base64(sign) -## 补充说明 -1.证书申请接口支持证书id和域名两种方式获取证书。 -2.autoApply=true将在没有证书时自动触发申请,申请过程中会提示`正在申请中`,可轮循获取状态,直到证书申请成功。 +## 参数 +支持证书id和域名两种方式获取证书。 + +## 创建新的证书申请 +参数autoApply=true,将在没有证书时自动触发申请证书,检查逻辑如下: +1. 如果证书仓库里面有,且没有过期,就直接返回证书 +2. 如果没有或者已过期,就会去找流水线,有就触发流水线执行 +3. 如果没有流水线,就创建一个流水线,触发运行(`注意:需要提前在域名管理中配置好域名校验方式,否则会申请失败`) +4. 再次采用相同参数请求接口,如果在申请过程中,就会提示`正在申请中`,可轮循获取状态,直到证书申请成功。 ## SDK