# (八) 签章状态退出
退出签章的两种方式:
App上操作退出签章,App退出签章界面,网页或客户端轮询签章状态得到App的通知,退出签章状态;
网页或客户端窗体中点击退出签章按钮,退出签章状态并通知App,App收到通知后退出签章界面。
# 1. 接收App退出签章通知的回调信息
前置条件:接收App服务端推送的退出签章回调数据后,平台才能获知App是否退出签章
平台接收回调数据,由手机App进行扫码并输入密码操作后,触发App服务端主动通过回调接口推送,成功接收后可查询到签章状态信息。回调过程见【回调接口】与【回调接口:type=12】
# 2. 查询App退出签章通知信息的接口
# (1) 接口方法url:sweepcodeSignController/getExitContinuitySignByApp
# (2) 请求参数:
参数名称 | 类型 | 是否必填 | 值示例 | 描述 |
---|---|---|---|---|
PId | String | 是 | 连续签章标识 |
请求示例:
http://123.121.159.112:8866/sweepcodeSignController/getExitContinuitySignByApp?PId=A3401314520b3359292cb054b0f95f497f5e031b816
1
# (3) 返回值:SweepCodeResult<TBExitReceiveEntity>
参数名称 | 类型 | 描述 |
---|---|---|
header | 响应头 | |
└ returnCode | String | 0成功;1失败 |
└ msg | String | 状态结果说明 |
└ size | Null | Null |
data | 对象 | |
└ createTime | Datetime | 退出通知记录时间 |
└ id | String | 数据库表中行标识id |
└ useStatus | Null | 未使用 |
└ pid | String | 连续签章事件组标识 |
└ source | String | 退出指令的来源00 app端,01 交易平台 |
└ exitType | String | 退出指令的类型 12:退出签章模式 |
响应示例:
{
"data": {
"createTime": null,
"exitType": null,
"id": null,
"pid": null,
"source": null,
"useStatus": null
},
"header": {
"msg": "成功",
"returnCode": "0",
"size": null
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 3. 交易平台通知App退出签章的接口
# (1) 接口方法url:sweepcodeSignController/exitContinuitySign
# (2) 请求参数:
参数名称 | 类型 | 是否必填 | 值示例 | 描述 |
---|---|---|---|---|
PId | String | 是 | 连续签章标识 | |
accessToken | String | 是 | 用户登录令牌 | |
platformCode | String | 是 | 平台编码 |
请求示例:
http://123.121.159.112:8866/sweepcodeSignController/exitContinuitySign?PId=A3401314520b3359292cb054b0f95f497f5e031b816&platformCode=A3401314520&accessToken=
1
# (3) 返回值:SweepCodeResult<String>
参数名称 | 类型 | 描述 |
---|---|---|
header | 响应头 | |
└ returnCode | String | 0成功;1失败 |
└ msg | String | 状态结果说明 |
└ size | Null | Null |
data | Null | Null |
响应示例:
{
"data": null,
"header": {
"msg": "成功",
"returnCode": "0",
"size": null
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
← (七) 查询用户签名值并用签名值合章 概述 →