>[success] 接口地址与请求方式
接口请求基础地址：http://jgfw.yichang.gov.cn/api/syncauth/login
请求方式：POST
字符编码：UTF-8
>[success] 参与验签的公共参数
|参数名称 | 数据类型 | 参数描述 |备注说明 |
| --- | --- | --- | --- |
| appId | String | 应用编号 | 请求客户端与服务端一致 |
|appSecret|String|私钥|请求客户端与服务端一致 |
| nonceStr| String|随机字符串|6到20位字母、数字组合 |
|timeStamp|Intger| 时间戳|自1970-01-01到现在的秒数 |
|deviceType| String| 设备类型| 固定为WEB |
| deviceId| String|设备标识| 取客户端IP或生成UUID |
|signature| String|数据签名| 最终的数据签名 |
以上公共参数除开私钥(appSecret)之外，其他参数都需要在请求时追加在请求的URL地址后面传递至服务端进行数据验签，appId与appSecret请求端、服务端保持一致；最终的请求示例如下：
```
http://jgfw.yichang.gov.cn/api/syncauth/login?appId=RSJ00001&deviceId=67D3D9A8-4D67-2444-71CE-66851AEDCFE1&deviceType=WEB&nonceStr=6PQfHMIv&timeStamp=1574251924&signature=6FF704C5DF1FB65BE046EC202BE353E0
```
>[success] body部分请求参数
在请求此接口时，需要将用户唯一的手机号码在请求的body部分以POST方式发送到服务端
|参数名称| 数据类型 |参数描述|备注说明|
| --- | --- |--- |--- |
|mobile|string|手机号码|例如：17386500821|
|url|string|跳转地址，可以为空||
最终请求地址与参数见下图：
>[info] 签名生成方法
(1)、将参与签名的公共参数appId、deviceId、deviceType、nonceStr、timeStamp按字典序排序顺序使用&连接拼接成字符串，例如：
```
appId=RSJ00001&deviceId=67D3D9A8-4D67-2444-71CE-66851AEDCFE1&deviceType=WEB&nonceStr=6PQfHMIv&timeStamp=1574251924
```
(2)、将私钥拼接到字符串的最末尾
```
appId=RSJ00001&deviceId=67D3D9A8-4D67-2444-71CE-66851AEDCFE1&deviceType=WEB&nonceStr=6PQfHMIv&timeStamp=1574251924&appSecret=8e85e612698296b4c522bfa7eb0b82a8
```
(3)、对以上拼接字符串进行sha1非可逆加密
```
sha1(appId=RSJ00001&deviceId=67D3D9A8-4D67-2444-71CE-66851AEDCFE1&deviceType=WEB&nonceStr=6PQfHMIv&timeStamp=1574251924&appSecret=8e85e612698296b4c522bfa7eb0b82a8)
```
(4)、将sha1加密后的结果再全部转大写
```
strtoupper(sha1(appId=RSJ00001&deviceId=67D3D9A8-4D67-2444-71CE-66851AEDCFE1&deviceType=WEB&nonceStr=6PQfHMIv&timeStamp=1574251924&appSecret=8e85e612698296b4c522bfa7eb0b82a8))
```
最终得到的签名结果如下：
```
6FF704C5DF1FB65BE046EC202BE353E0
```
**注意**
1、 以上书写中字符拼接都不包含空格(空格为word书写自动换行产生的)；
2、 无论是参数名还是值都严格区分大小写;
>[danger] 接口响应结果
无论请求成功或失败，接口将返回JSON数据格式的数据，JSON数据格式都包含code与msg两个公共字段，其中code=1时表示请求成功，code非时请求失败。
请求成功返回如下结果：
```
{"code":1,"msg":"success","time":"1638169006","data":{"jumpUrl":"http:\\/\\/minzheng.n3.cn:81\\/wui\\/index.html?ssoToken=ssoToken","ssoToken":"ssoToken"}}
```
请求失败时返回如下结果：
```
{"code":0,"msg":"签名错误!"}
```
| 参数名称 | 数据类型 |参数描述|备注说明|
| --- | --- |--- |--- |
|code|Intger|请求结果码| 1为成功，非1失败|
|msg|String|接口结果描述|具体错误描述信息|
|data|Object|接口数据|只有在请求成功是返回|
|data>>jumpUrl|String|登录成功后的跳转地址||
|data>>ssoToken|String|登录成功后的ssoToken||
>[danger] 获取待办列表
接口请求地址：http://jgfw.yichang.gov.cn/api/synctodo/getTodoList
请求方式：POST
参数格式：JSON(UTF-8)
请求参数：
| 参数名称 | 数据类型 |参数描述|备注说明|
| --- | --- |--- |--- |
|mobile|String|用户手机号码|例如：13477304418|
响应参数：
| 参数名称 | 数据类型 |参数描述|备注说明|
| --- | --- |--- |--- |
|code|Intger|请求结果码| 1为成功，非1失败|
|msg|String|接口结果描述|具体错误描述信息|
|data|Object|接口数据|只有在请求成功是返回|
|data>>rowCount|Intger|待办数量||
|data>>items|Array|待办列表||
|data>>items>>requestId|Intger|流程请求ID|例如：10412|
|data>>items>>sano|String|单据编号|例如：QMXX20210709000002|
|data>>items>>title|String|单据标题|例如：签名信息采集-白骥-2021-07-09|
|data>>items>>url|String|待办处理地址||
|data>>items>>creatorId|Intger|流程发起用户编号|22|
|data>>items>>creatorName|String|流程发起用户姓名|例如：白骥|
|data>>items>>workflowName|String|流程名称|例如：签名信息采集|
|data>>items>>workflowTypeId|Intger|流程类型编号|例如：100|
|data>>items>>workflowTypeName|String|流程类型名称|例如：日常办公|
