中招互连CA互认平台对接文档 v0.1

# (七) 查询用户签名值并用签名值合章

客户端和网页合章的区别

  本步骤执行两个操作：取得签名值和使用签名值对文件合章。客户端本地通过签章控件完成合章操作，故只需获取签名值即可；网页合章则是在后台完成取得签名值和使用签名值对文件合章两个操作。

# 1. 接收用户签名值的回调信息

前置条件：接收App服务端推送的用户签名值回调数据后，平台才能使用签名值进行合章

  平台接收回调数据，由手机App进行扫码并输入密码操作后，触发App服务端主动通过回调接口推送，成功接收后可查询用户签名值信息。回调过程见【回调接口】与【回调接口：type=03】

# 2. 查询用户签名值的接口(只客户端对接)

#   (1) 接口方法url：sweepcodeController/getSignatureValue

#   (2) 请求参数：

参数名称 类型 是否必填 值示例 描述
tId String 是 事件ID

  请求示例：

http://123.121.159.112:8866/sweepcodeController/getSignatureValue?tId=D11000001522a3908bee18f48748d401d0e9f16f20d
1

#   (3) 返回值：

参数名称 类型 描述
header 响应头
└ returnCode String 0成功;1失败
└ msg String 状态结果说明
└ size Null Null
data 对象
└ caOrgType String CA机构类型编码
└ signatureValue text 一个CA签名值（签章不取这里）
└ pubCert text 公钥证书
└ algorithm String 加密算法
└ signOriVal String 签名原值
└ signatureValueList Json 一组CA签名值
└ └ signKey String 签名文档ID
└ └ signOriVal String 签名原值
└ └ signatureValue String CA签名值结果（签章取这里）

  响应示例：

{
    "data": {
        "algorithm": "RSA",
        "caOrgType": "010002",
        "certSn": "59E28B2B1B5946A429F453ED865E55B3B7777B6B",
        "createTime": "2021/7/12 15:56:01",
        "id": "EE7C4658-1A27-445B-A019-269794E15C3B",
        "personalTransactionCode": "0592A2BE39AE47A08BA36624225676B1",
        "pubCert": "MIIESTCCAzGgAwIBAgIU",
        "signOriVal": null,
        "signOriValList": null,
        "signatureValue": null,
        "signatureValueList": "[{\"signKey\":\"AH-0001\",\"signOriVal\":\"KLrGRVnvfvF3lJmuR84dGxk4qAA\\u003d\",\"signatureValue\":\"MIIGCgYJKoZIhvcNAQcC"}]",
        "tid": "E1100000285dd8b66fcb3d24f198f975055e0c13ce8",
        "type": "14",
        "unifiedTransactionCode": "76A0E64FFA9B45D083CB17B650310972",
        "useStatus": null
    },
    "header": {
        "msg": "获取成功",
        "returnCode": "0",
        "size": null
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 3. 查询签名值并合章的接口(针对签单章的合章)

#   (1) 接口方法url：sweepcodeSignController/noIdentitySignatureValueSealPDF

#   (2) 请求参数：

参数名称 类型 是否必填 值示例 描述
tId String 是 事件ID
coordinateLongitudinal String 是 签章X坐标
coordinateTransverse Sting 是 签章Y坐标
coordinatePage Sting 是 签章页码
sealBelong Sting 否 印章所属
sealImage Sting 是 印章图片
src Sting 是 签章网络路径
signFieldName Sting 是 签章域名
signMode Sting 是 签章加密方式
sealImageType Sting 否 印章类型
signatureReason Sting 否 签章原因

  请求示例：

http://123.121.159.112:8866/sweepcodesignController/noIdentitySignatureValueSealPDF?tId=D11000001522a3908bee18f48748d401d0e9f16f20d&coordinateLongitudinal=136&coordinatePage=1&coordinateTransverse=130&sealImage=&signFieldName=signFieldName1630661146834&signMode=RSA&signatureReason=测试&src=/Content/UploadFiles/637662867038670698.pdf
1

#   (3) 返回值：

参数名称 类型 描述
header 响应头
└ returnCode String 0成功;1失败
└ msg String 状态结果说明
└ size Null Null
data 对象
└ caOrgType String CA机构类型编码
└ signatureValue text 一个CA签名值（签章不取这里）
└ pubCert text 公钥证书
└ algorithm String 加密算法

  响应示例：

{
    "data": {
        "algorithm": "RSA",
        "caOrgType": "010002",
        "pubCert": "MIIESTCCAzGgAwIBAgIU",
        "signatureValue": "MIIGCgYJKoZIhvcNAQcC"
    },
    "header": {
        "msg": "获取成功",
        "returnCode": "0",
        "size": null
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 4. 查询签名值并合章的接口(针对批量签的合章)

#   (1) 接口方法url：sweepcodeSignController/batchSynthesisSignature

#   (2) 请求参数：

参数名称 类型 是否必填 值示例 描述
tId String 是 事件ID
sealImage Sting 是 印章图片
src Sting 是 签章网络路径
signFieldName Sting 是 签章域名
signMode Sting 是 签章加密方式
location Sting 否 印章类型
reason Sting 否 签章原因

  请求示例：

http://123.121.159.112:8866/sweepcodeSignController/batchSynthesisSignature?tId=D11000001522a3908bee18f48748d401d0e9f16f20d&sealImage=&signFieldName=signFieldName1630661146834&signMode=RSA&reason=测试&src=/Content/UploadFiles/637662867038670698.pdf
1

#   (3) 返回值：

参数名称 类型 描述
header 响应头
└ returnCode String 0成功;1失败
└ msg String 状态结果说明
└ size Null Null
data 对象
└ caOrgType String CA机构类型编码
└ signatureValue text 一个CA签名值（签章不取这里）
└ pubCert text 公钥证书
└ algorithm String 加密算法

  响应示例：

{
    "data": {
        "algorithm": "RSA",
        "caOrgType": "010002",
        "pubCert": "MIIESTCCAzGgAwIBAgIU",
        "signatureValue": "MIIGCgYJKoZIhvcNAQcC"
    },
    "header": {
        "msg": "获取成功",
        "returnCode": "0",
        "size": null
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 5. 查询签名值并合章的接口(针对关键字签的合章)

#   (1) 接口方法url：sweepcodeSignController/synthesisSignatureKeyword

#   (2) 请求参数：

参数名称 类型 是否必填 值示例 描述
tId String 是 事件ID
keyword String 是 关键字
sealImage Sting 是 印章图片
src Sting 是 签章网络路径
signFieldName Sting 是 签章域名
signMode Sting 是 签章加密方式
location Sting 否 印章类型
reason Sting 否 签章原因

  请求示例：

http://123.121.159.112:8866/sweepcodeSignController/synthesisSignatureKeyword?tId=D11000001522a3908bee18f48748d401d0e9f16f20d&sealImage=&signFieldName=signFieldName1630661146834&signMode=RSA&reason=测试&src=/Content/UploadFiles/637662867038670698.pdf&keyword=签字
1

#   (3) 返回值：

参数名称 类型 描述
header 响应头
└ returnCode String 0成功;1失败
└ msg String 状态结果说明
└ size Null Null
data 对象
└ caOrgType String CA机构类型编码
└ signatureValue text 一个CA签名值（签章不取这里）
└ pubCert text 公钥证书
└ algorithm String 加密算法

  响应示例：

{
    "data": {
        "algorithm": "RSA",
        "caOrgType": "010002",
        "pubCert": "MIIESTCCAzGgAwIBAgIU",
        "signatureValue": "MIIGCgYJKoZIhvcNAQcC"
    },
    "header": {
        "msg": "获取成功",
        "returnCode": "0",
        "size": null
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 6. 查询签名值并合章的接口(针对骑缝签的合章)

#   (1) 接口方法url：sweepcodeSignController/gapSynthesisSignature

#   (2) 请求参数：

参数名称 类型 是否必填 值示例 描述
tId String 是 事件ID
coordinateLongitudinal String 否 签章X坐标
coordinateTransverse Sting 否 签章Y坐标
sealImage Sting 是 印章图片
src Sting 是 签章网络路径
signFieldName Sting 是 签章域名
signMode Sting 是 签章加密方式
location Sting 否 印章类型
reason Sting 否 签章原因

  请求示例：

http://123.121.159.112:8866/sweepcodeSignController/gapSynthesisSignature?tId=D11000001522a3908bee18f48748d401d0e9f16f20d&sealImage=&signFieldName=signFieldName1630661146834&signMode=RSA&reason=测试&src=/Content/UploadFiles/637662867038670698.pdf
1

#   (3) 返回值：

参数名称 类型 描述
header 响应头
└ returnCode String 0成功;1失败
└ msg String 状态结果说明
└ size Null Null
data 对象
└ caOrgType String CA机构类型编码
└ signatureValue text 一个CA签名值（签章不取这里）
└ pubCert text 公钥证书
└ algorithm String 加密算法

  响应示例：

{
    "data": {
        "algorithm": "RSA",
        "caOrgType": "010002",
        "pubCert": "MIIESTCCAzGgAwIBAgIU",
        "signatureValue": "MIIGCgYJKoZIhvcNAQcC"
    },
    "header": {
        "msg": "获取成功",
        "returnCode": "0",
        "size": null
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

← (八) 签章状态退出 →