线路类型一[普通集群负载-IP接口]
线路类型二[普通集群负载-域名接口]
说明:域名接口会自动分发请求到普通集群服务器均衡负载,该域名TTL值为60秒,表示你的请求会每60秒实现自动轮换负载服务器,但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障,也可能会造成个别地区存在一定时间的故障期。
线路类型三[VIP集群负载-VIP线路接口]
说明:VIP专属大带宽服务器集群组,每次请求自动均衡负载,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!最低24¥/月,登录后购买。注:VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等,并非收费接口包月使用。
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 操作类型 | type | 是 | 1=申请订单,2=获取证书,3=查询历史订单证书。一般第一步先执行申请订单操作,然后再调用本接口获取证书。如果操作失败,请多次重试或等待1分钟后再尝试。申请与获取操作超时时间建议为30秒以上。例:type=1 |
| 域名 | domain | 否 | 要申请签发证书的域名,主域名或二级域名,也可以是泛域名。申请订单时必须传,获取证书或查询订单不用传。例:domain=ssl.apihz.cn |
| 订单号 | order | 否 | 获取证书或查询历史订单证书时必须传订单号,例:order=9bfdfd8155efd6e313914256dc3b8ec6 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功,400错误 |
| 提示信息 | msg | 信息提示。 |
| 订单号 | order | 订单号,申请订单操作成功时必返回。 |
| DNS记录 | dnsurl | 申请订单后请到你的域名服务商处添加DNS解析。添加解析后请等待解析生效后再进行获取证书操作。 |
| DNS类型 | dnstype | DNS解析类型,一般为txt。 |
| DNS记录值 | dnsvalue | DNS解析记录内容。 |
| 证书信息数据集 | data | 证书信息数据集,获取证书或查询历史订单时返回。 |
| 证书秘钥 | data.zskey | 证书秘钥,内容包含\\n换行符,请自行替换为对应场景的换行。可直接用于宝塔等。 |
| 证书PEM格式 | data.zspem | 证书PEM格式,内容包含\\n换行符,请自行替换为对应场景的换行。可直接用于宝塔等。 |
| 到期时间 | data.expires_at | 证书到期时间。 |
| 签发域名 | data.domain | 签发域名。 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"msg": "提交申请成功,请进行DNS解析",
"order": "8e15b1d070280456ee60461663409db8",
"dnsurl": "_acme-challenge.ssl.xxx.xyz",
"dnstype": "TXT",
"dnsvalue": "TgS8vRupvrNnWis3X369tZvoDWlRmU21aEcpppu29a0"
}
示例:
{
"code": 200,
"msg": "验证成功",
"order": "62ca5e4ff9476064773ce2d96554260d",
"data": {
"zskey": "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCtPcGLxsqhHo8B\nqfLYoFdbRRszrLtxQEqEBzaUTUzqbr9FjkQFtBRgN4g6Uq8h90DbLhCSXUuF2cnl\nuGB3s4+Nn7pz7PRAsyxbnff9GJlG3IQPMKEE6z8IXSNxGUKuttVwL9VJ5n2lZmch\naAx7AGrES3MiyYaxoUWJXQoOmxtEJqT7ORgjkdi57ts5p2QgLzp7q9UeQULJFGZ+\nzwBOxRqrkdKasbVBnUuMnbbC4N7zIaz/KoLv15f9hjjUxUmdXkyc5s/tlwDgFoYk\ncQBfu6GkwDC8fpEQzCvLm+OECfItUoimcCc5mvfqwVo9J4HThCrCSq4ZIjtI2joL\n171iCylZAgMBAAECggEAdpgQJt+vVxzUSQ9Ob31UT+a++GEG8EBSwo8tjdhdDx9B\nURxS9JSSXkultkdkHJxmiaS/M3MqgDbXP6s4XrlNTGZL/Y/4pVICy7UYTurIAvpy\nbPOdRwDD5bXczU+9ll0TP/l+yVhAKzou32+bG5jtffMonmfXDUKZl69ZcyY7RCsP\noQxdMBsHcfy+K5s7lb8nMWcnbRWB6vRJK/E3NHXGuFC9xBFPxs/Xqo/7uM6YO/30\njzQ4F0CssXMC83S2GJAcE1vwh7FGB3fw7XMvLGROXlMgWdlqAWAShk5LXk4OoBhX\nnYABNKaI37vHq/0EQMyHy4hx3naCOwdxcf4gb82VAQKBgQDcnNa/vbp+GxTiYgNM\ncp9E7JvoZceqruiFOxHJEfgbFvZJiOJrWgwU4b2l/zFlsGGeFt5HCKPv+sYnqsUH\nQbh0XRVEQm5bSYtK0KRirTBylPTX5an5xv92bhHoTgCRRwhP5st+7+39g7rHz69e\nqC07h9z6NKBiYiutepyX6g/QEwKBgQDJB6x9TWrwo/C0UjNjuUdNqIs31bU3sFJK\n/I8APl682jm4bQWW0pIinSMK3wQZ4pP1RNLyzJWBYSd7lK9QhlcHKCBnrSg0Dfky\ntuz0bt81QUT2tf+pZSGvTaYAEbzMALoElYLiawvxPKMDxoytlvnC5xJrXMpVg6jR\nQs7xtuXGYwKBgQCqSL1R/wamNA0ouHLHXWomb2PgPD+kNaHwxKlzxFT3w/+Svv/V\n0QmmTKBwMsxUK5MNzaUAu2Ce6bhuAdhXQ5k26Gpz57r654eG1gksyXWt2+ApjXJo\nA/xH06oq35p8iJGX6xOEBXpzxmwzstEwhSt02eftkRWDGzePjia088wE1QKBgQC5\n7Qv+M8z1VVq5G9GFqQWmcHyaHmBlagEic2W63vR2DAsYZFSoAoa/1r9jPZIocqNP\nU+EaSFb5+yYuKPzgJ+9zogwed0rYohfZbM/I3oY4Ve53kyoqvGskHFesdrs7nmxs\n8u7DhCfebKuEQW0424qSVW52t7I21vca24RUkEkBawKBgGeDmq/O2xNVVX8FIlJe\njUDc5AnkSAF/6yzbzZRPOGGhPk/KY0mEL49DFcaPKmifqdg9Hnkr4CrMPofa0A5a\nvDDX9PGKnakGmlaqVV85R1YJxjd/7hSKMGC7vPL2C+Z+PjnnsgUl6WZuCxdMY8kY\noLw7qmicktXivibT1UNjt+Hc\n-----END PRIVATE KEY-----\n",
"zspem": "-----BEGIN CERTIFICATE-----\nMIIE8TCCA9mgAwIBAgISBY7W/YyWIM1fJJKIPdWJI7z9MA0GCSqGSIb3DQEBCwUA\nMDMxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MQwwCgYDVQQD\nEwNSMTMwHhcNMjYwNDA5MTA0NjM4WhcNMjYwNzA4MTA0NjM3WjAWMRQwEgYDVQQD\nEwtzczEubDAwLnh5ejCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK09\nwYvGyqEejwGp8tigV1tFGzOsu3FASoQHNpRNTOpuv0WORAW0FGA3iDpSryH3QNsu\nEJJdS4XZyeW4YHezj42funPs9ECzLFud9/0YmUbchA8woQTrPwhdI3EZQq621XAv\n1UnmfaVmZyFoDHsAasRLcyLJhrGhRYldCg6bG0QmpPs5GCOR2Lnu2zmnZCAvOnur\n1R5BQskUZn7PAE7FGquR0pqxtUGdS4ydtsLg3vMhrP8qgu/Xl/2GONTFSZ1eTJzm\nz+2XAOAWhiRxAF+7oaTAMLx+kRDMK8ub44QJ8i1SiKZwJzma9+rBWj0ngdOEKsJK\nrhkiO0jaOgvXvWILKVkCAwEAAaOCAhowggIWMA4GA1UdDwEB/wQEAwIFoDATBgNV\nHSUEDDAKBggrBgEFBQcDATAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBSdd0471baz\ngoEomxyLexyxVV4NGDAfBgNVHSMEGDAWgBTnq58PLDOgU9NeT3jIsoQOO9aSMzAz\nBggrBgEFBQcBAQQnMCUwIwYIKwYBBQUHMAKGF2h0dHA6Ly9yMTMuaS5sZW5jci5v\ncmcvMBYGA1UdEQQPMA2CC3NzMS5sMDAueHl6MBMGA1UdIAQMMAowCAYGZ4EMAQIB\nMC8aA1UdHwQoMCYwJKAioCCGHmh0dHA6Ly9yMTMuYy5sZW5jci5vcmcvMTI2LmNy\nbDCCAQwGCisGAQQB1nkCBAIEgf0EgfoA+AB3AK9niDtXsE7dj6bZfvYuqOuBCsdx\nYPAkXlXWDC/nhYc6AAABnXIPdJUAAAQDAEgwRgIhAOKvkbj5oVry6UoN0MCID4J3\nADgqjj1iQEcI1jB0j9UpAiEAvLGZ45MZiT2/Nzw8GRL9s6KITy4lcvzkE/aELjFH\n0GIAfQCoJsvjCsY1EkZTP+Bl8U8Z2W4ZCBPEHdlteQCzEjxVJwAAAZ1yD3d5AAgA\nAAUABjdHygQDAEYwRAIgVUxVer/NwppXdAnKiNnvkTXKyJ1rSp17gUyz5CNvdvwC\nIAZqOQt6fjSkIu2gZqgmmt1WE7qaYGsluAeqTDUdOclvMA0GCSqGSIb3DQEBCwUA\nA4IBAQA6LnwlyuloyLs91C84k3MwMeQBPcOX1+c0K6xceu6O/ZbsEK11pEzEBsUc\nZWFa6bM1/791oGjxbGBNUXhqOYevU2q+8qRxckCFz3O+k8CeeAE/+egfJ//96pNL\nlAuEoRqVAjIq7klGvmdE/dDnVKVaKZ4Umfu+n5u4/L6QrT1WyaGkz1dF39NBWRjg\nrojCcSe9lC1+MMUBkv9odu10FL1X+jfVCcr6UvKHUtHqjZ6WKlTeolcWVnyBKkZK\nXD5lnpqP2NdOycrUH3nsIz0EvjyyMkwZBlysGo0RKy9d7ylx86jEFp3miY88R4jH\ne8GzeQOapQOvKSbza5atP/7PzSna\n-----END CERTIFICATE-----\n\n-----BEGIN CERTIFICATE-----\nMIIFBTCCAu2gAwIBAgIQWgDyEtjUtIDzkkFX6imDcTANBgkqhkiG9w0BAQsFADBP\nMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFy\nY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBYMTAeFw0yNDAzMTMwMDAwMDBa\nFw0yNzAzMTIyMzU5NTlaMDMxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBF\nbmNyeXB0MQwwCgYDVQQDEwNSMTMwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK\nAoIBAQClZ3CN0FaBZBUXYc25BtStGZCMJlA3mBZjklTb2cyEBZPs0+wIG6BgUUNI\nfSvHSJaetC3ancgnO1ehn6vw1g7UDjDKb5ux0daknTI+WE41b0VYaHEX/D7YXYKg\nL7JRbLAaXbhZzjVlyIuhrxA3/+OcXcJJFzT/jCuLjfC8cSyTDB0FxLrHzarJXnzR\nyQH3nAP2/Apd9Np75tt2QnDr9E0i2gB3b9bJXxf92nUupVcM9upctuBzpWjPoXTi\ndYJ+EJ/B9aLrAek4sQpEzNPCifVJNYIKNLMc6YjCR06CDgo28EdPivEpBHXazeGa\nXP9enZiVuppD0EqiFwUBBDDTMrOPAgMBAAGjgfgwgfUwDgYDVR0PAQH/BAQDAgGG\nMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDATASBgNVHRMBAf8ECDAGAQH/\nAgEAMB0GA1UdDgQWBBTnq58PLDOgU9NeT3jIsoQOO9aSMzAfBgNVHSMEGDAWgBR5\ntFnme7bl5AFzgAiIyBpY9umbbjAyBggrBgEFBQcBAQQmMCQwIgYIKwYBBQUHMAKG\nFmh0dHA6Ly94MS5pLmxlbmNyLm9yZy8wEwYDVR0gBAwwCjAIBgZngQwBAgEwJwYD\nVR0fBCAwHjAcoBqgGIYWaHR0cDovL3gxLmMubGVuY3Iub3JnLzANBgkqhkiG9w0B\nAQsFAAOCAgEAUTdYUqEimzW7TbrOypLqCfL7VOwYf/Q79OH5cHLCZeggfQhDconl\nk7Kgh8b0vi+/XuWu7CN8n/UPeg1vo3G+taXirrytthQinAHGwc/UdbOygJa9zuBc\nVyqoH3CXTXDInT+8a+c3aEVMJ2St+pSn4ed+WkDp8ijsijvEyFwE47hulW0Ltzjg\n9fOV5Pmrg/zxWbRuL+k0DBDHEJennCsAen7c35Pmx7jpmJ/HtgRhcnz0yjSBvyIw\n6L1QIupkCv2SBODT/xDD3gfQQyKv6roV4G2EhfEyAsWpmojxjCUCGiyg97FvDtm/\nNK2LSc9lybKxB73I2+P2G3CaWpvvpAiHCVu30jW8GCxKdfhsXtnIy2imskQqVZ2m\n0Pmxobb28Tucr7xBK7CtwvPrb79os7u2XP3O5f9b/H66GNyRrglRXlrYjI1oGYL/\nf4I1n/Sgusda6WvA6C190kxjU15Y12mHU4+BxyR9cx2hhGS9fAjMZKJss28qxvz6\nAxu4CaDmRNZpK/pQrXF17yXCXkmEWgvSOEZy6Z9pcbLIVEGckV/iVeq0AOo2pkg9\np4QRIy0tK2diRENLSF2KysFwbY6B26BFeFs3v1sYVRhFW9nLkOrQVporCS0KyZmf\nwVD89qSTlnctLcZnIavjKsKUu1nA1iU0yYMdYepKR7lWbnwhdx3ewok=\n-----END CERTIFICATE-----\n",
"expires_at": "2026-07-08 18:46:37",
"domain": "ssl.xxx.xyz"
}
}
更新记录
2026-04-09 16:00:06 - 新增接口。