Model对象定义
CertDetails
| 参数名称 |
类型 |
描述 |
| productId |
String |
证书ID |
| productName |
String |
产品名称 |
| brand |
String |
证书品牌 |
| certType |
String |
证书类型 |
| productType |
String |
产品类型 |
| domainNumber |
int |
标准域名数量 |
| wildcardNumber |
int |
通配符域名数量 |
| status |
String |
证书状态 |
| processStatus |
String |
申请状态 |
| applyTime |
Timestamp |
申请时间 |
| submitTime |
Timestamp |
上传时间 |
| effectTime |
Timestamp |
生效时间 |
| expireTime |
Timestamp |
到期时间 |
| createTime |
Timestamp |
创建时间 |
| errorMessage |
String |
失败原因 |
| verifyMode |
String |
验证方式 |
| domainName |
String |
主域名 |
| bindDomains |
List |
绑定域名列表 |
| value |
String |
dns 或 file验证内容 |
| fileUrl |
String |
file验证时候要求的地址 |
| dnsName |
String |
dns验证时要求的name |
| host |
String |
CNAME验证主机名 |
| cnamevalue |
String |
CNAME验证值 |
| type |
String |
验证类型 |
| httpFilename |
String |
HTTP验证文件名 |
| httpvalue |
String |
HTTP验证内容 |
| leftTime |
Long |
验证剩余时间(秒) |
| downloadSupported |
boolean |
证书是否可下载 |
| duration |
int |
证书时长 |
| timeUnit |
String |
时长单位 |
| fromBaidu |
boolean |
是否为百度证书 |
说明:字段值为 null 时不返回。列表/查询接口返回的是精简版 CertDetails,证书详情接口返回的字段更全(含 fromBaidu 等)。
CertStatus
| 取值 |
对应状态 |
| APPLY_PENDING |
待申请 |
| APPLYING |
申请中 |
| NORMAL |
申请成功 |
| FAILED |
申请失败 |
| RENEW_PENDING |
待续费 |
| RENEW_INITIAL |
待完成续费订单 |
| RENEWING_TO_BE_APPLY |
续费中-待申请 |
| RENEWING |
续费中-申请中 |
| RENEW_NORMAL |
续费成功 |
| REPLACING |
重新颁发 |
| REPLACING_FAILED |
重新颁发失败 |
| REPLACING_NORMAL |
重新颁发成功 |
| REPLACING_CONFIRM |
重新颁发待确认 |
| REPLACE_CA |
重颁发信息确认后,需要提交信息至CA |
| EXPIRED |
已过期 |
| DELETED |
已删除 |
| REJECTED |
重新颁发被拒绝 |
CertType
| 取值 |
对应类型 |
| DV |
DV(域名型) |
| OV |
OV(企业型) |
| EV |
EV(增强型) |
| OVPRO |
企业型专业版(OV PRO)证书 |
| EVPRO |
增强型专业版(EV PRO)证书 |
CertBrand
| 取值 |
对应类型 |
| SECURESITE |
DigiCert SecureSite |
| GEOTRUST |
GeoTrust |
| GLOBALSIGN |
GlobalSign |
| CFCA |
CFCA |
| TRUSTASIA |
TrustAsia |
| DIGICERT |
DigiCert Basic |
| SSLTRUS |
锐安信 |
| UNITRUST |
UniTrust |
ProductType
| 取值 |
对应类型 |
| SINGLE |
单域名 |
| MULTI |
多域名版 |
| WILDCARD |
通配符域名版 |
| SINGLE_PRO |
单域名专业版 |
| MULTI_PRO |
多域名专业版 |
| WILDCARD_PRO |
通配符域名专业版 |
OrderType
NewOrderConfig
| 参数名称 |
类型 |
是否必需 |
参数位置 |
描述 |
| version |
String |
是 |
URL参数 |
API版本号 |
| brand |
String |
是 |
BODY |
证书品牌 取值见附录CertBrand |
| certType |
String |
是 |
BODY |
证书类型 取值见附录CertType |
| productType |
String |
是 |
BODY |
产品类型 取值见 ProductType |
| domainNumber |
int |
是 |
BODY |
标准域名数量 |
| wildcardNumber |
int |
是 |
BODY |
通配符域名数量 |
| purchaseLength |
int |
是 |
BODY |
购买时长(每个品牌每种证书不一定相同,具体参见控制台) |
| timeUnit |
String |
否 |
BODY |
时间单位,默认 YEAR(可选 MONTH、YEAR) |
| orderType |
String |
否 |
BODY |
订单类型,默认 NEW,取值见附录 OrderType |
| autoApply |
boolean |
否 |
BODY |
是否下单后自动申请,默认 false |
| serviceType |
String |
否 |
BODY |
服务类型 |
EncryptionType
| 取值 |
对应类型 |
| RSA |
RSA 算法 |
| ECDSA |
椭圆曲线加密算法 |
| SM2 |
国密非对称加密算法 |
EncryptionStrength
| 取值 |
对应加密类型 |
| RSA_2048 |
RSA |
| RSA_3072 |
RSA |
| RSA_4096 |
RSA |
| RSA_8192 |
RSA |
| ECDSA_PRIME256V1 |
ECDSA |
| ECDSA_PRIME384V1 |
ECDSA |
| ECDSA_PRIME224V1 |
ECDSA |
| ECDSA_PRIME521V1 |
ECDSA |
| SM2_SM2P256V1 |
SM2 |
HashAlgo
| 取值 |
描述 |
| SHA1 |
SHA1 |
| SHA256 |
SHA256 |
| SHA384 |
SHA384(默认) |
| SHA512 |
SHA512 |
| SM3 |
国密摘要算法 |
| MD5 |
MD5 |
AuthType
| 验证方式 |
描述 |
| DNS |
DNS 验证(CNAME/TXT) |
| DNS_TXT |
DNS TXT 记录验证 |
| FILE |
文件验证 |
| TXT |
TXT 验证 |
| EMAIL |
邮箱验证 |
| HTTP |
HTTP 文件验证 |
| HTTPS |
HTTPS 文件验证 |
| CNAME |
CNAME 验证 |
| IP |
IP 地址验证 |
Region
注意以下取值需要使用地区编码
| 字段 |
释义 |
| province |
省,取值见下方「地区编码对照表」 |
| city |
市/区,取值见下方「地区编码对照表」 |
| country |
国家编码(中国为 086) |
CertFileType
| 取值 |
描述 |
| PEM |
PEM 通用格式 |
| PEM_APACHE |
Apache 使用的 PEM |
| PEM_NGINX |
Nginx 使用的 PEM |
| PEM_HAPROXY |
Haproxy 使用的 PEM |
| JKS_TOMCAT |
Tomcat 8.5+ 使用的 JKS |
| JKS |
JKS 格式 |
| PKCS12 |
PKCS12 格式 |
| ALL |
全部格式打包 |
地区编码对照表(city_code)
Region 中 province / city 字段填写下表 code;country 字段填写国家编码(中国为 086)。000000 表示默认。
| 编码 |
地区 |
| 110000 |
北京市 |
| 110100 |
东城区 |
| 110200 |
西城区 |
| 110300 |
丰台区 |
| 110400 |
海淀区 |
| 110500 |
朝阳区 |
| 110600 |
石景山区 |
| 110700 |
房山区 |
| 110800 |
平谷区 |
| 110900 |
怀柔区 |
| 111000 |
大兴区 |
| 111100 |
门头沟区 |
| 111200 |
顺义区 |
| 111300 |
昌平区 |
| 111400 |
密云县 |
| 111500 |
延庆县 |
| 111600 |
通州区 |
| 120000 |
天津市 |
| 120100 |
和平区 |
| 120200 |
河东区 |
| 120300 |
河西区 |
| 120400 |
南开区 |
| 120500 |
河北区 |
| 120600 |
红桥区 |
| 120700 |
滨海新区 |
| 120800 |
东丽区 |
| 120900 |
西青区 |
| 121000 |
津南区 |
| 121100 |
北辰区 |
| 121200 |
武清区 |
| 121300 |
宝坻区 |
| 121400 |
宁河县 |
| 121500 |
静海县 |
| 121600 |
蓟县 |
| 130000 |
河北省 |
| 130100 |
石家庄市 |
| 130200 |
唐山市 |
| 130300 |
秦皇岛市 |
| 130400 |
邯郸市 |
| 130500 |
邢台市 |
| 130600 |
保定市 |
| 130700 |
张家口市 |
| 130800 |
承德市 |
| 130900 |
沧州市 |
| 131000 |
廊坊市 |
| 131100 |
衡水市 |
| 140000 |
山西省 |
| 140100 |
太原市 |
| 140200 |
大同市 |
| 140300 |
阳泉市 |
| 140400 |
长治市 |
| 140500 |
晋城市 |
| 140600 |
朔州市 |
| 140700 |
晋中市 |
| 140800 |
运城市 |
| 140900 |
忻州市 |
| 141000 |
临汾市 |
| 141100 |
吕梁市 |
| 150000 |
内蒙古自治区 |
| 150100 |
呼和浩特市 |
| 150200 |
包头市 |
| 150300 |
乌海市 |
| 150400 |
赤峰市 |
| 150500 |
通辽市 |
| 150600 |
鄂尔多斯市 |
| 150700 |
呼伦贝尔市 |
| 150800 |
巴彦淖尔市 |
| 150900 |
乌兰察布市 |
| 152200 |
兴安盟 |
| 152500 |
锡林郭勒盟 |
| 152900 |
阿拉善盟 |
| 210000 |
辽宁省 |
| 210100 |
沈阳市 |
| 210200 |
大连市 |
| 210300 |
鞍山市 |
| 210400 |
抚顺市 |
| 210500 |
本溪市 |
| 210600 |
丹东市 |
| 210700 |
锦州市 |
| 210800 |
营口市 |
| 210900 |
阜新市 |
| 211000 |
辽阳市 |
| 211100 |
盘锦市 |
| 211200 |
铁岭市 |
| 211300 |
朝阳市 |
| 211400 |
葫芦岛市 |
| 220000 |
吉林省 |
| 220100 |
长春市 |
| 220200 |
吉林市 |
| 220300 |
四平市 |
| 220400 |
辽源市 |
| 220500 |
通化市 |
| 220600 |
白山市 |
| 220700 |
松原市 |
| 220800 |
白城市 |
| 222400 |
延边朝鲜族自治州 |
| 230000 |
黑龙江省 |
| 230100 |
哈尔滨市 |
| 230200 |
齐齐哈尔市 |
| 230300 |
鸡西市 |
| 230400 |
鹤岗市 |
| 230500 |
双鸭山市 |
| 230600 |
大庆市 |
| 230700 |
伊春市 |
| 230800 |
佳木斯市 |
| 230900 |
七台河市 |
| 231000 |
牡丹江市 |
| 231100 |
黑河市 |
| 231200 |
绥化市 |
| 232700 |
大兴安岭地区 |
| 310000 |
上海市 |
| 310100 |
黄浦区 |
| 310200 |
卢湾区 |
| 310300 |
徐汇区 |
| 310400 |
长宁区 |
| 310500 |
静安区 |
| 310600 |
普陀区 |
| 310700 |
闸北区 |
| 310800 |
虹口区 |
| 310900 |
杨浦区 |
| 311000 |
浦东新区 |
| 311100 |
宝山区 |
| 311200 |
闵行区 |
| 311300 |
嘉定区 |
| 311400 |
金山区 |
| 311500 |
松江区 |
| 311600 |
青浦区 |
| 311700 |
奉贤区 |
| 311800 |
崇明县 |
| 320000 |
江苏省 |
| 320100 |
南京市 |
| 320200 |
无锡市 |
| 320300 |
徐州市 |
| 320400 |
常州市 |
| 320500 |
苏州市 |
| 320600 |
南通市 |
| 320700 |
连云港市 |
| 320800 |
淮安市 |
| 320900 |
盐城市 |
| 321000 |
扬州市 |
| 321100 |
镇江市 |
| 321200 |
泰州市 |
| 321300 |
宿迁市 |
| 330000 |
浙江省 |
| 330100 |
杭州市 |
| 330200 |
宁波市 |
| 330300 |
温州市 |
| 330400 |
嘉兴市 |
| 330500 |
湖州市 |
| 330600 |
绍兴市 |
| 330700 |
金华市 |
| 330800 |
衢州市 |
| 330900 |
舟山市 |
| 331000 |
台州市 |
| 331100 |
丽水市 |
| 340000 |
安徽省 |
| 340100 |
合肥市 |
| 340200 |
芜湖市 |
| 340300 |
蚌埠市 |
| 340400 |
淮南市 |
| 340500 |
马鞍山市 |
| 340600 |
淮北市 |
| 340700 |
铜陵市 |
| 340800 |
安庆市 |
| 341000 |
黄山市 |
| 341100 |
滁州市 |
| 341200 |
阜阳市 |
| 341300 |
宿州市 |
| 341400 |
巢湖市 |
| 341500 |
六安市 |
| 341600 |
亳州市 |
| 341700 |
池州市 |
| 341800 |
宣城市 |
| 350000 |
福建省 |
| 350100 |
福州市 |
| 350200 |
厦门市 |
| 350300 |
莆田市 |
| 350400 |
三明市 |
| 350500 |
泉州市 |
| 350600 |
漳州市 |
| 350700 |
南平市 |
| 350800 |
龙岩市 |
| 350900 |
宁德市 |
| 360000 |
江西省 |
| 360100 |
南昌市 |
| 360200 |
景德镇市 |
| 360300 |
萍乡市 |
| 360400 |
九江市 |
| 360500 |
新余市 |
| 360600 |
鹰潭市 |
| 360700 |
赣州市 |
| 360800 |
吉安市 |
| 360900 |
宜春市 |
| 361000 |
抚州市 |
| 361100 |
上饶市 |
| 370000 |
山东省 |
| 370100 |
济南市 |
| 370200 |
青岛市 |
| 370300 |
淄博市 |
| 370400 |
枣庄市 |
| 370500 |
东营市 |
| 370600 |
烟台市 |
| 370700 |
潍坊市 |
| 370800 |
济宁市 |
| 370900 |
泰安市 |
| 371000 |
威海市 |
| 371100 |
日照市 |
| 371200 |
莱芜市 |
| 371300 |
临沂市 |
| 371400 |
德州市 |
| 371500 |
聊城市 |
| 371600 |
滨州市 |
| 371700 |
菏泽市 |
| 410000 |
河南省 |
| 410100 |
郑州市 |
| 410200 |
开封市 |
| 410300 |
洛阳市 |
| 410400 |
平顶山市 |
| 410500 |
安阳市 |
| 410600 |
鹤壁市 |
| 410700 |
新乡市 |
| 410800 |
焦作市 |
| 410900 |
濮阳市 |
| 411000 |
许昌市 |
| 411100 |
漯河市 |
| 411200 |
三门峡市 |
| 411300 |
南阳市 |
| 411400 |
商丘市 |
| 411500 |
信阳市 |
| 411600 |
周口市 |
| 411700 |
驻马店市 |
| 420000 |
湖北省 |
| 420100 |
武汉市 |
| 420200 |
黄石市 |
| 420300 |
十堰市 |
| 420500 |
宜昌市 |
| 420600 |
襄樊市 |
| 420700 |
鄂州市 |
| 420800 |
荆门市 |
| 420900 |
孝感市 |
| 421000 |
荆州市 |
| 421100 |
黄冈市 |
| 421200 |
咸宁市 |
| 421300 |
随州市 |
| 422800 |
恩施土家族苗族自治州 |
| 430000 |
湖南省 |
| 430100 |
长沙市 |
| 430200 |
株洲市 |
| 430300 |
湘潭市 |
| 430400 |
衡阳市 |
| 430500 |
邵阳市 |
| 430600 |
岳阳市 |
| 430700 |
常德市 |
| 430800 |
张家界市 |
| 430900 |
益阳市 |
| 431000 |
郴州市 |
| 431100 |
永州市 |
| 431200 |
怀化市 |
| 431300 |
娄底市 |
| 433100 |
湘西土家族苗族自治州 |
| 440000 |
广东省 |
| 440100 |
广州市 |
| 440200 |
韶关市 |
| 440300 |
深圳市 |
| 440400 |
珠海市 |
| 440500 |
汕头市 |
| 440600 |
佛山市 |
| 440700 |
江门市 |
| 440800 |
湛江市 |
| 440900 |
茂名市 |
| 441200 |
肇庆市 |
| 441300 |
惠州市 |
| 441400 |
梅州市 |
| 441500 |
汕尾市 |
| 441600 |
河源市 |
| 441700 |
阳江市 |
| 441800 |
清远市 |
| 441900 |
东莞市 |
| 442000 |
中山市 |
| 445100 |
潮州市 |
| 445200 |
揭阳市 |
| 445300 |
云浮市 |
| 450000 |
广西壮族自治区 |
| 450100 |
南宁市 |
| 450200 |
柳州市 |
| 450300 |
桂林市 |
| 450400 |
梧州市 |
| 450500 |
北海市 |
| 450600 |
防城港市 |
| 450700 |
钦州市 |
| 450800 |
贵港市 |
| 450900 |
玉林市 |
| 451000 |
百色市 |
| 451100 |
贺州市 |
| 451200 |
河池市 |
| 451300 |
来宾市 |
| 451400 |
崇左市 |
| 460000 |
海南省 |
| 460100 |
海口市 |
| 460200 |
三亚市 |
| 500000 |
重庆市 |
| 500100 |
渝中区 |
| 500200 |
沙坪坝区 |
| 500300 |
江北区 |
| 500400 |
南岸区 |
| 500500 |
大渡口区 |
| 500600 |
九龙坡区 |
| 500700 |
巴南区 |
| 500800 |
渝北区 |
| 500900 |
北碚区 |
| 501000 |
永川区 |
| 501100 |
江津区 |
| 501200 |
合川区 |
| 501300 |
双桥区 |
| 501400 |
万盛区 |
| 501500 |
南川区 |
| 501600 |
涪陵区 |
| 501700 |
长寿区 |
| 501800 |
万州区 |
| 501900 |
黔江区 |
| 502000 |
潼南县 |
| 502100 |
铜梁县 |
| 502200 |
大足县 |
| 502300 |
荣昌县 |
| 502400 |
璧山县 |
| 502500 |
綦江县 |
| 502600 |
城口县 |
| 502700 |
巫溪县 |
| 502800 |
巫山县 |
| 502900 |
开县 |
| 503000 |
云阳县 |
| 503100 |
奉节县 |
| 503200 |
梁平县 |
| 503300 |
忠县 |
| 503400 |
垫江县 |
| 503500 |
丰都县 |
| 503600 |
秀山县 |
| 503700 |
酉阳县 |
| 503800 |
石柱县 |
| 503900 |
彭水县 |
| 504000 |
武隆县 |
| 510000 |
四川省 |
| 510100 |
成都市 |
| 510300 |
自贡市 |
| 510400 |
攀枝花市 |
| 510500 |
泸州市 |
| 510600 |
德阳市 |
| 510700 |
绵阳市 |
| 510800 |
广元市 |
| 510900 |
遂宁市 |
| 511000 |
内江市 |
| 511100 |
乐山市 |
| 511300 |
南充市 |
| 511400 |
眉山市 |
| 511500 |
宜宾市 |
| 511600 |
广安市 |
| 511700 |
达州市 |
| 511800 |
雅安市 |
| 511900 |
巴中市 |
| 512000 |
资阳市 |
| 513200 |
阿坝藏族羌族自治州 |
| 513300 |
甘孜藏族自治州 |
| 513400 |
凉山彝族自治州 |
| 520000 |
贵州省 |
| 520100 |
贵阳市 |
| 520200 |
六盘水市 |
| 520300 |
遵义市 |
| 520400 |
安顺市 |
| 522200 |
铜仁地区 |
| 522300 |
黔西南布依族苗族自治州 |
| 522400 |
毕节地区 |
| 522600 |
黔东南苗族侗族自治州 |
| 522700 |
黔南布依族苗族自治州 |
| 530000 |
云南省 |
| 530100 |
昆明市 |
| 530300 |
曲靖市 |
| 530400 |
玉溪市 |
| 530500 |
保山市 |
| 530600 |
昭通市 |
| 530700 |
丽江市 |
| 530800 |
普洱市 |
| 530900 |
临沧市 |
| 532300 |
楚雄彝族自治州 |
| 532500 |
红河哈尼族彝族自治州 |
| 532600 |
文山壮族苗族自治州 |
| 532800 |
西双版纳傣族自治州 |
| 532900 |
大理白族自治州 |
| 533100 |
德宏傣族景颇族自治州 |
| 533300 |
怒江傈僳族自治州 |
| 533400 |
迪庆藏族自治州 |
| 540000 |
西藏自治区 |
| 540100 |
拉萨市 |
| 542100 |
昌都地区 |
| 542200 |
山南地区 |
| 542300 |
日喀则地区 |
| 542400 |
那曲地区 |
| 542500 |
阿里地区 |
| 542600 |
林芝地区 |
| 610000 |
陕西省 |
| 610100 |
西安市 |
| 610200 |
铜川市 |
| 610300 |
宝鸡市 |
| 610400 |
咸阳市 |
| 610500 |
渭南市 |
| 610600 |
延安市 |
| 610700 |
汉中市 |
| 610800 |
榆林市 |
| 610900 |
安康市 |
| 611000 |
商洛市 |
| 620000 |
甘肃省 |
| 620100 |
兰州市 |
| 620200 |
嘉峪关市 |
| 620300 |
金昌市 |
| 620400 |
白银市 |
| 620500 |
天水市 |
| 620600 |
武威市 |
| 620700 |
张掖市 |
| 620800 |
平凉市 |
| 620900 |
酒泉市 |
| 621000 |
庆阳市 |
| 621100 |
定西市 |
| 621200 |
陇南市 |
| 622900 |
临夏回族自治州 |
| 623000 |
甘南藏族自治州 |
| 630000 |
青海省 |
| 630100 |
西宁市 |
| 632100 |
海东地区 |
| 632200 |
海北藏族自治州 |
| 632300 |
黄南藏族自治州 |
| 632500 |
海南藏族自治州 |
| 632600 |
果洛藏族自治州 |
| 632700 |
玉树藏族自治州 |
| 632800 |
海西蒙古族藏族自治州 |
| 640000 |
宁夏回族自治区 |
| 640100 |
银川市 |
| 640200 |
石嘴山市 |
| 640300 |
吴忠市 |
| 640400 |
固原市 |
| 640500 |
中卫市 |
| 650000 |
新疆维吾尔自治区 |
| 650100 |
乌鲁木齐市 |
| 650200 |
克拉玛依市 |
| 650300 |
石河子市 |
| 652100 |
吐鲁番地区 |
| 652200 |
哈密地区 |
| 652300 |
昌吉回族自治州 |
| 652700 |
博尔塔拉蒙古自治州 |
| 652800 |
巴音郭楞蒙古自治州 |
| 652900 |
阿克苏地区 |
| 653000 |
克孜勒苏柯尔克孜自治州 |
| 653100 |
喀什地区 |
| 653200 |
和田地区 |
| 654000 |
伊犁哈萨克自治州 |
| 654200 |
塔城地区 |
| 654300 |
阿勒泰地区 |
| 710000 |
台湾 |
| 810000 |
香港 |
| 820000 |
澳门 |
| 000000 |
默认 |
| 429000 |
省直辖行政单位 |
| 469000 |
省直辖县级行政单位 |