4.1 概述

前提条件：第三方应用在天威诚信电子认证云服务平台进行应用注册，获得应用标识和应用密钥。

异常相应结果参数及格式如下：

Ø status：状态码，1表示成功；小于1表示失败；

Ø message：对调用失败原因的描述；

4.2 通用约束

Ø 所有请求内容类型使用application/json;charset=UTF-8

Ø 所有涉及到编码的环节一律采用UTF-8（例如URLEncoding、String转byte[]等）；

Ø 当接口参数为二进制字节数组时，一律Base64编码后再传递；

Ø 所有图片数据限制在2M以内；

4.3 安全性设计

通讯安全：

Ø 采用SSL安全连接，防止信息篡改、中间人窃听和重放攻击；

访问安全：

Ø 请求时，需要将appId（应用标识）, serviceCode（产品编码），加入HTTP协议的HEADER中；

Ø 请求中请求方必须带Content-Signature签名值，签名的内容为“JSON格式的请求参数”，签名密钥为 “应用密钥+serviceCode ”，确保信息的不被篡改。

4.4 路径地址

测试地址：http://demo-open.itruscloud.com/apigate

正式地址：http://open.itruscloud.com/apigate

4.5 证书签发服务接口定义

基本信息：

请求参数：

返回值：

4.6 证书更新服务接口定义

基本信息：

请求参数：

返回值：

4.7 证书吊销服务接口定义

基本信息：

请求参数：

返回值：

4.8 证书查询服务接口定义

基本信息：

请求参数：

返回值：

QueryCertResult类型结构：

certInfo类型：

userInfo类型：

输出示例：

{

    "status":1,

    "queryInfo":{

        "totalSize":0,

        "certInfos":[

            {

                "certStatus":"REVOKE",

                "certReqDate":"20230919162102",

                "certReqBufType":"PKCS10",

                "certReqChallenge":"yAUqysPhkHLcmV72oDXz+AW52oI=",

                "certSignDate":"20230919162102",

                "certSerialNumber":"313FF7E6D9DFE026B30BEABBD8A29AC1264776D0",

                "certNotBefore":"20230919162101",

                "certNotAfter":"20240929161909",

                "certIssuerHashMd5":"",

                "certIssuerDn":"CN=天威诚信数字认证中心CA, OU=SM2证书系统, O=北京天威诚信电子商务服务有限公司, C=CN",

                "certSubjectHashMd5":"",

                "certSubjectDn":"CN=深圳市腾讯科技有限公司测试, SERIALNUMBER=IDnum:12**********bc, OU=test@qq.com, OU=广西壮族自治区大数据发展局（中国—东盟信息港建设办公室、广西壮族自治区政务服务监督管理办公室）, O=北京天威诚信电子商务服务有限公司",

                "certRevokeDate":"20230919162502",

                "certRevokeReason":"unknown",

                "certRenewalDate":"20230919162102",

                "certRenewalPrevId":0,

                "certRenewalNextId":0,

                "certReqOverrideValidity":375,

                "id":0,

                "certReqBuf":"MIIBBjCBrQIBADBLMQswCQYDVQQGDAJDTjEMMAoGA1UEAwwDZ3dtMREwDwYDVQQHDAhIb25nS29uZzEMMAoGA1UECgwDSVQuMQ0wCwYDVQQLDAREZXB0MFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAE4lnHjxQWCTLqV8LtWtihZER+cIa+YVWkBrF2HRCh/ZFMhxeyzfGN7l/w8b3ttWj2qRWFTbJ75DMAWDOTfLTlU6AAMAoGCCqBHM9VAYN1A0gAMEUCIBd6tw57tmlcBr8ewtpvUsFTKdBGUls1scj7W4L4hOkzAiEA8ORM0PV3oKBdLv1PYPFeyWcaRiYkkc0szFacEbecXVk=",

                "certSignBuf":"MIIDjjCCAzKgAwIBAgIUMT/35tnf4CazC+q72KKawSZHdtAwDAYIKoEcz1UBg3UFADCBjTELMAkGA1UEBhMCQ04xOTA3BgNVBAoMMOWMl+S6rOWkqeWogeivmuS/oeeUteWtkOWVhuWKoeacjeWKoeaciemZkOWFrOWPuDEYMBYGA1UECwwPU00y6K+B5Lmm57O757ufMSkwJwYDVQQDDCDlpKnlqIHor5rkv6HmlbDlrZforqTor4HkuK3lv4NDQTAeFw0yMzA5MTkwODIxMDFaFw0yNDA5MjkwODE5MDlaMIIBPTE5MDcGA1UECgww5YyX5Lqs5aSp5aiB6K+a5L+h55S15a2Q5ZWG5Yqh5pyN5Yqh5pyJ6ZmQ5YWs5Y+4MYGYMIGVBgNVBAsMgY3lub/opb/lo67ml4/oh6rmsrvljLrlpKfmlbDmja7lj5HlsZXlsYDvvIjkuK3lm73igJTkuJznm5/kv6Hmga/muK/lu7rorr7lip7lhazlrqTjgIHlub/opb/lo67ml4/oh6rmsrvljLrmlL/liqHmnI3liqHnm5HnnaPnrqHnkIblip7lhazlrqTvvIkxFDASBgNVBAsMC3Rlc3RAcXEuY29tMR0wGwYDVQQFDBRJRG51bToxMioqKioqKioqKipiYzEwMC4GA1UEAwwn5rex5Zyz5biC6IW+6K6v56eR5oqA5pyJ6ZmQ5YWs5Y+45rWL6K+VMFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAE4lnHjxQWCTLqV8LtWtihZER+cIa+YVWkBrF2HRCh/ZFMhxeyzfGN7l/w8b3ttWj2qRWFTbJ75DMAWDOTfLTlU6OBujCBtzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIE8DCBnAYDVR0fBIGUMIGRMIGOoIGLoIGIhoGFaHR0cDovL3RvcGNhLml0cnVzLmNvbS5jbi9wdWJsaWMvaXRydXNjcmw/Q0E9MkEwOTdDMkQzQzZEMEE3NjA1QUZGNTREOTIyRjk4Q0QwNDkwQTMyQiZzZz1IQUNDNzZBMkZGRDM2RTI2NzQ1NjZFMzNFRTE4NzBFMUJGQkM3MzVGQjRCNjAMBggqgRzPVQGDdQUAA0gAMEUCIB0Cau6jlbe+FAekiLZcJ/h27KQG8MMIfz0+sflfOehCAiEApjSd9tUWFK2hLIdeMT9KewpdJnAdlgRDaqP1aiwOS8E=",

                "certType":"enccert",

                "certKmcRep1":"userSeal=MHkCIQCJlz0R0VgBT9AzJx64YZpW2ZntTnSsrLP52iXEA2F51wIgAuLJSc%2F10rTHA6jbczs1sQzGZgOnzsxHE%2Ff4gbRHHkoEIJESsiudOzPeYj9pFibFvNtL7%2FPW0ji5IGfdKM%2FZlDIpBBC4FSOUKmBJWLUCveiNpuQ4&encPrivateKeyUser=dm6PrrWhnv7uyEvmZFay%2BJmdkisQhIy6JcRpI2MxGkZigNzyeH5RdcXatACiPRzq&KEY_ID=107356231&userIV=1qR%2B9H1F81O8TSHEeMgUBg%3D%3D&userCipher=AES",

                "certKmcRep2":"MIIDpDCCA0mgAwIBAgIUSe0IepYVnwj+YNvSdQ2o70/qg3swDAYIKoEcz1UBg3UFADCBjTELMAkGA1UEBhMCQ04xOTA3BgNVBAoMMOWMl+S6rOWkqeWogeivmuS/oeeUteWtkOWVhuWKoeacjeWKoeaciemZkOWFrOWPuDEYMBYGA1UECwwPU00y6K+B5Lmm57O757ufMSkwJwYDVQQDDCDlpKnlqIHor5rkv6HmlbDlrZforqTor4HkuK3lv4NDQTAeFw0yMzA5MTkwODIxMDFaFw0yNDA5MjkwODE5MDlaMIIBPTE5MDcGA1UECgww5YyX5Lqs5aSp5aiB6K+a5L+h55S15a2Q5ZWG5Yqh5pyN5Yqh5pyJ6ZmQ5YWs5Y+4MYGYMIGVBgNVBAsMgY3lub/opb/lo67ml4/oh6rmsrvljLrlpKfmlbDmja7lj5HlsZXlsYDvvIjkuK3lm73igJTkuJznm5/kv6Hmga/muK/lu7rorr7lip7lhazlrqTjgIHlub/opb/lo67ml4/oh6rmsrvljLrmlL/liqHmnI3liqHnm5HnnaPnrqHnkIblip7lhazlrqTvvIkxFDASBgNVBAsMC3Rlc3RAcXEuY29tMR0wGwYDVQQFDBRJRG51bToxMioqKioqKioqKipiYzEwMC4GA1UEAwwn5rex5Zyz5biC6IW+6K6v56eR5oqA5pyJ6ZmQ5YWs5Y+45rWL6K+VMFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAErgK7iNMSVNadEzgfoGQ18S4w3GN9lliulIZlocwmWOElIMZAeT2vO9H6mO0KKS7qBAOGSOwGJMVYVNq4orCRQ6OB0TCBzjAJBgNVHRMEAjAAMAsGA1UdDwQEAwIFIDCBnAYDVR0fBIGUMIGRMIGOoIGLoIGIhoGFaHR0cDovL3RvcGNhLml0cnVzLmNvbS5jbi9wdWJsaWMvaXRydXNjcmw/Q0E9MkEwOTdDMkQzQzZEMEE3NjA1QUZGNTREOTIyRjk4Q0QwNDkwQTMyQiZzZz1IQUNDNzZBMkZGRDM2RTI2NzQ1NjZFMzNFRTE4NzBFMUJGQkM3MzVGQjRCNjAVBgdggRwBBgoCBAoMCElUUlVTS01DMAwGCCqBHM9VAYN1BQADRwAwRAIgNZBOzVlY4fkzmQMyokNiwjWKzlNU5rlVZZHFpFvM5ncCIDId2bX4XGescLFhaBIPruBMFkTwovtMCwzvl5+4+Irm",

                "certKmcRep3":"49ED087A96159F08FE60DBD2750DA8EF4FEA837B",

                "certDeliverMode":"",

                "certRenewemailDeliver":"0",

                "certReqBufTypeKmc":"PKCS10",

                "certSignBufKmc":"MIIDpDCCA0mgAwIBAgIUSe0IepYVnwj+YNvSdQ2o70/qg3swDAYIKoEcz1UBg3UFADCBjTELMAkGA1UEBhMCQ04xOTA3BgNVBAoMMOWMl+S6rOWkqeWogeivmuS/oeeUteWtkOWVhuWKoeacjeWKoeaciemZkOWFrOWPuDEYMBYGA1UECwwPU00y6K+B5Lmm57O757ufMSkwJwYDVQQDDCDlpKnlqIHor5rkv6HmlbDlrZforqTor4HkuK3lv4NDQTAeFw0yMzA5MTkwODIxMDFaFw0yNDA5MjkwODE5MDlaMIIBPTE5MDcGA1UECgww5YyX5Lqs5aSp5aiB6K+a5L+h55S15a2Q5ZWG5Yqh5pyN5Yqh5pyJ6ZmQ5YWs5Y+4MYGYMIGVBgNVBAsMgY3lub/opb/lo67ml4/oh6rmsrvljLrlpKfmlbDmja7lj5HlsZXlsYDvvIjkuK3lm73igJTkuJznm5/kv6Hmga/muK/lu7rorr7lip7lhazlrqTjgIHlub/opb/lo67ml4/oh6rmsrvljLrmlL/liqHmnI3liqHnm5HnnaPnrqHnkIblip7lhazlrqTvvIkxFDASBgNVBAsMC3Rlc3RAcXEuY29tMR0wGwYDVQQFDBRJRG51bToxMioqKioqKioqKipiYzEwMC4GA1UEAwwn5rex5Zyz5biC6IW+6K6v56eR5oqA5pyJ6ZmQ5YWs5Y+45rWL6K+VMFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAErgK7iNMSVNadEzgfoGQ18S4w3GN9lliulIZlocwmWOElIMZAeT2vO9H6mO0KKS7qBAOGSOwGJMVYVNq4orCRQ6OB0TCBzjAJBgNVHRMEAjAAMAsGA1UdDwQEAwIFIDCBnAYDVR0fBIGUMIGRMIGOoIGLoIGIhoGFaHR0cDovL3RvcGNhLml0cnVzLmNvbS5jbi9wdWJsaWMvaXRydXNjcmw/Q0E9MkEwOTdDMkQzQzZEMEE3NjA1QUZGNTREOTIyRjk4Q0QwNDkwQTMyQiZzZz1IQUNDNzZBMkZGRDM2RTI2NzQ1NjZFMzNFRTE4NzBFMUJGQkM3MzVGQjRCNjAVBgdggRwBBgoCBAoMCElUUlVTS01DMAwGCCqBHM9VAYN1BQADRwAwRAIgNZBOzVlY4fkzmQMyokNiwjWKzlNU5rlVZZHFpFvM5ncCIDId2bX4XGescLFhaBIPruBMFkTwovtMCwzvl5+4+Irm",

                "certSerialnumberKmc":"49ED087A96159F08FE60DBD2750DA8EF4FEA837B",

                "certIdRandom":""

            }

        ],

        "userInfos":[

            {

                "accountId":9109,

                "userName":"深圳市腾讯科技有限公司测试",

                "userSerialnumber":"313FF7E6D9DFE026B30BEABBD8A29AC1264776D0",

                "userOrganization":"北京天威诚信电子商务服务有限公司",

                "userOrgunit":"广西壮族自治区大数据发展局（中国—东盟信息港建设办公室、广西壮族自治区政务服务监督管理办公室）",

                "userAdditionalField1":"test@qq.com",

                "userAdditionalField9":"1",

                "userAdditionalField10":"12345678990abc"

            }

        ]

    }

}

4.9 证书挂起服务接口定义

基本信息：

请求参数：

返回值：

4.10 证书解挂服务接口定义

基本信息：

请求参数：

返回值：

4.11 证书补发服务接口定义

基本信息：

请求参数：

返回值：

4.12 证书获取协议接口定义

基本信息：

请求参数：

返回值：

4.13 错误码