跳到主要内容

修改 DCV 接口

当用户想域名验证方式时，需要调用此接口

请求​

Content-Type: application/json
Content-Length: 127

{
  "service_id": "o91bZ", // 证书编号，证书下单接口返回的 `service_id`
  "domain_dcv": { // 域名+验证信息，必传，一条域名对应一种验证类型
    "*.example.com": "dns", //⚠️注意：通配符只支持dns或email验证
    "example2.com": "http", //⚠️注意：http、https为子域名文件验证必须上传到子域名本身服务下，不支持传主域名或其他域名
    "example3.com": "https",
    "sub.example4.com": "admin@example4.com" // ⚠️注意：邮箱验证不支持whois邮箱，只支持admin@、administrator@、postmaster@、webmaster@、hostmaster@ + <子域名 或 主域名> 组合的邮箱
  }
}

响应​

HTTP/1.1 200 OK

Content-Type: application/json
Content-Length: 36

{
  "success": true,
  "message": "OK"
}
危险

用户解析、文件验证操作好之前，不要调用此接口；由于DNS存在缓存，当CA一次查询不到解析结果通常会被缓存数分钟，这会导致缓存期间您（或您客户）的证书一直不会得到签发。

正确的处理应该是用户解析完成后，您在您系统平台给用户一个点击按钮“检查解析结果” / “检查文件内容”的按钮。此按钮同步调用此接口。这样对接通常您API下的订单会在用户解析完成后1分钟内签发，从而达到的客户体验。