Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


API_FUNCTION_NAME构造后的API Endpoint
addSSLOrderhttps://api.trustocean.com/ssl/v2/addSSLOrder


业务参数

参数名称类型必须条件数据要求数据举例
pidstring创建订单时必须提供必须是由 getProductList 返回的产品列表中的产品 id 编号46
periodstring必须是由 getProductList 返回的产品列表中的产品的有效订购周期Annually
csr_codestring用于创建证书CSR代码, 格式请参考参数解释
-----BEGIN CERTIFICATE REQUEST-----
MIIC/jCCAeYCAQAwgbgxCzAJBgNVBAYTAkNOMRAwDgYDVQQIDAdTaGFhbnhpMQ0w
CwYDVQQHDARYaWFuMSMwIQYDVQQKDBpRaWFvS3IgQ29ycG9yYXRpb24gTGltaXRl
ZDEjMCEGA1UECwwaUWlhb0tyIENvcnBvcmF0aW9uIExpbWl0ZWQxGzAZBgNVBAMM
Em15LmZ1bGwuZG9tYWluLnRsZDEhMB8GCSqGSIb3DQEJARYSc3VwcG9ydEBxaWFv
a3IuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtiZi/0Z6UUGR
i4c2t0+kDyTdwhYUgEzytbIzSutFnz6WIusISCExy3S7C27CUVmVuY1Qpv9cR1bq
mEpwe+j/AB5nH7Pc06rStmpRTb7OWRDMMIm/2MAXQ06w4de4IvURWM2M4b0x5kha
GOvgx3bDcYuo4eHHHa+q9iZU+dkWdN30AXCazWfTk1cYGwLOamZHQZr1D+XjplV9
Ump1mqNFPVNvBgua1CzhwqOKnADeeptNBl9ez45Zx2Xq/XS9YNboOM+g+45/qjuY
C46ECfoggZk+6W4irykaR/yfo2/5ScYGRy0XvX6JLfGsUHF85L60g70+zYvDmYvK
AoI2GwkmFQIDAQABoAAwDQYJKoZIhvcNAQEFBQADggEBAB4Mw7XUfC9xrzApXcI8
QQ60mz37OvGgg2TftKK2GKiOo7B3mYwC8cVDKq1s31CukBOnOduvI206V1v/sbkW
o1STQ7MuUMnrp8P+mgQHyYBttnN+g8HyEDueH7KOjYD9rKfAaDaaJyxSPStHwEhK
fdSmbWTVAmc2VFp8jhMY2vjx9A6XuoDnyc2eXY6r2V6n/HTw/2YT0jCJFUxnNcCF
54AybyBdU1eBsnOvTWPmNAYikw1aoWYz2+xwOBQ7+5UYeVrdkhRTwnrJluVr+jgb
vIwyQM92B6gzi1zXU/cqpEnOpkUVnkp4H1Y4N+D09iYqwaS+VBmrV0vbbebQTKEN
JUg=
-----END CERTIFICATE REQUEST-----
domainsstring创建多域名证书时必须提供英文逗号隔开的域名或IP地址, 末尾不跟逗号domain.com,www.domain.com,my.doamin.com,11.89.102.12,xcert.domain.com
contact_emailstring创建订单时必须提供格式正确的,合法的,有效的证书申请人的联系电子邮箱地址contact@trustocean.com
dcv_methodstring如果存在 `domains`参数, 这里的`dcv_method`应该按照域名列表内的顺序列出所有域名的验证方式, 用英文逗号隔开, 末尾不跟逗号。http,dns,https,admin@domain.tld,dns
unique_idstring11-20位英文英文字母和数字组合, 全局不可重复, 每个订单唯一编号 tbltrust2019a00921
renewstring创建续费订单时必须提供标记为续费订单, 仅当值为 "yes" 时有效,标记后为此新证书订单额外免费增加30-90天有效期,根据CA机构的政策符合时才会额外增加有效期。yes
organization_namestring创建企业OV 、EV订单是必须提供填写信息必须和营业执照一致西安某某信息科技有限公司
organizationalUnitNamestring技术部
registered_address_line1string陕西省西安市雁塔区某某大厦1-1008号
registered_nostringAS82019961002927SJXSD
countrystring国际国家名称英文字符编码CN
statestring填写信息必须和营业执照一致陕西
citystring西安
postal_codestring710000
organization_phonestring用于企业电话验证的公开的企业联系电话, 请查看《企业认证电话可信数据库目录》,只有在此目录中查询到的电话号码才可用。02988188289
date_of_incorporationstring执照一致, 注册日期, 格式如: 2005-08-282005-08-09
contact_namestring填写信息必须为实际的终端客户/证书联系人信息司马建国
contact_titlestringCEO
contact_phonestring13000000001



成功响应

Code Block
languagejs
themeConfluence
title成功响应
{
    "status": "success",
    "vendor_id": "192847737",
    "cert_status": "enroll_caprocessing",
    "dcv_info": {
        "trustocean.com": {
            "status": "needverification",
            "method": "http",
            "email": "",
            "isip": "false",
            "subdomain": null,
            "topdomain": "trustocean.com",
            "http_verifylink": "http://trustocean.com/.well-knowknown/pki-validation/9BBE6D86D535A3EF6E8008975AC6A0BE.txt",
            "http_filename": "9BBE6D86D535A3EF6E8008975AC6A0BE.txt",
            "http_filecontent": "70030c1e989f209855aea0013d92ee9f1f56cca9794a7e9a9353975e7fa7be59\r\ncomodoca.com\r\ntestorder02"
        },
        "www.trustocean.com": {
            "status": "needverification",
            "method": "dns",
            "email": "",
            "isip": "false",
            "subdomain": "www",
            "topdomain": "trustocean.com",
            "dns_host": "_9bbe6d86d535a3ef6e8008975ac6a0be.www",
            "dns_type": "CNAME",
            "dns_value": "70030c1e989f209855aea0013d92ee9f.1f56cca9794a7e9a9353975e7fa7be59.testorder02.comodoca.com"
        },
        "cmcc.qiaokr.com": {
            "status": "needverification",
            "method": "email",
            "email": "admin@qiaokr.com",
            "isip": "false",
            "subdomain": "cmcc",
            "topdomain": "qiaokr.com"
        }
    },
    "unique_id": "testorder02",
    "created_at": "2018-12-14 14:57:33",
    "trustocean_id": 1908,
    "csr_code": "-----BEGIN CERTIFICATE REQUEST-----\nMIIC/jCCAeYCAQAwgbgxCzAJBgNVBAYTAkNOMRAwDgYDVQQIDAdTaGFhbnhpMQ0w\nCwYDVQQHDARYaWFuMSMwIQYDVQQKDBpRaWFvS3IgQ29ycG9yYXRpb24gTGltaXRl\nZDEjMCEGA1UECwwaUWlhb0tyIENvcnBvcmF0aW9uIExpbWl0ZWQxGzAZBgNVBAMM\nEm15LmZ1bGwuZG9tYWluLnRsZDEhMB8GCSqGSIb3DQEJARYSc3VwcG9ydEBxaWFv\na3IuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtiZi/0Z6UUGR\ni4c2t0+kDyTdwhYUgEzytbIzSutFnz6WIusISCExy3S7C27CUVmVuY1Qpv9cR1bq\nmEpwe+j/AB5nH7Pc06rStmpRTb7OWRDMMIm/2MAXQ06w4de4IvURWM2M4b0x5kha\nGOvgx3bDcYuo4eHHHa+q9iZU+dkWdN30AXCazWfTk1cYGwLOamZHQZr1D+XjplV9\nUmp1mqNFPVNvBgua1CzhwqOKnADeeptNBl9ez45Zx2Xq/XS9YNboOM+g+45/qjuY\nC46ECfoggZk+6W4irykaR/yfo2/5ScYGRy0XvX6JLfGsUHF85L60g70+zYvDmYvK\nAoI2GwkmFQIDAQABoAAwDQYJKoZIhvcNAQEFBQADggEBAB4Mw7XUfC9xrzApXcI8\nQQ60mz37OvGgg2TftKK2GKiOo7B3mYwC8cVDKq1s31CukBOnOduvI206V1v/sbkW\no1STQ7MuUMnrp8P+mgQHyYBttnN+g8HyEDueH7KOjYD9rKfAaDaaJyxSPStHwEhK\nfdSmbWTVAmc2VFp8jhMY2vjx9A6XuoDnyc2eXY6r2V6n/HTw/2YT0jCJFUxnNcCF\n54AybyBdU1eBsnOvTWPmNAYikw1aoWYz2+xwOBQ7+5UYeVrdkhRTwnrJluVr+jgb\nvIwyQM92B6gzi1zXU/cqpEnOpkUVnkp4H1Y4N+D09iYqwaS+VBmrV0vbbebQTKEN\nJUg=\n-----END CERTIFICATE REQUEST-----",
    "contact_email": "idev@qiaokr.com",
    "domains": [
        "trustocean.com",
        "www.trustocean.com",
        "cmcc.qiaokr.com"
    ]
}


业务说明和提示

此操作将实时提交订单数据至颁发机构, 创建新的证书订单。

若您提交的是企业OV、EV订单,提交后将获得 enroll_organization_pre 状态, 等待TRUSTOCEAN确认企业信息之后,将会提交至颁发机构

可能返回的状态

根据订单提交操作和订单类型的不同, 可能会返回的订单状态如下

订单状态(cert_status)解释
enroll_caprocessing提交成功, 订单信息已经将请求提交至证书颁发机构
enroll_organization_pre提交成功, TRUSTOCEAN正在审查企业信息, 一旦完成审查将会自动提交至颁发机构