说明
clientId和clientSecret的索取联系:xiezhi@eazytec.com
行业区域政企通
domain-com企业端说明
序号 | 系统 | 环境 | 地址 | 备注 |
---|---|---|---|---|
1 | 卓易政企通 | 测试 | https://test-authorize.eazytec-cloud.com | 适用【园企通】【行业政企通】【乡镇政企通】【协会政企通】 |
2 | 卓易政企通 | 线上 | https://authorize.eazytec-cloud.com | 适用【园企通】【行业政企通】【乡镇政企通】【协会政企通】 |
3 | 宜兴政企通 | 测试 | https://test-authorize-yxzqt.eazytec-cloud.com | 适用【宜兴政企通】 |
4 | 宜兴政企通 | 线上 | https://authorize-yxzqt.eazytec-cloud.com | 适用【宜兴政企通】 |
5 | 江苏政企通 | 测试 | https://test-authorize-jszqt.eazytec-cloud.com | 适用【江苏政企通】 |
6 | 江苏政企通 | 线上 | https://authorize-jszqt.eazytec-cloud.com | 适用【江苏政企通】 |
domain-gov政府端说明
序号 | 系统 | 环境 | 地址 | 备注 |
---|---|---|---|---|
1 | 卓易政企通 | 测试 | https://test-gov-authorize.eazytec-cloud.com | 适用【园企通】【行业政企通】【乡镇政企通】【协会政企通】 |
2 | 卓易政企通 | 线上 | https://gov-authorize.eazytec-cloud.com | 适用【园企通】【行业政企通】【乡镇政企通】【协会政企通】 |
3 | 宜兴政企通 | 测试 | https://test-gov-authorize-yxzqt.eazytec-cloud.com | 适用【宜兴政企通】 |
4 | 宜兴政企通 | 线上-互联网 | https://gov-authorize-yxzqt.eazytec-cloud.com | 适用【宜兴政企通】 |
5 | 宜兴政企通 | 线上-政务外网 | http://10.168.37.14:30084(vpn) http://2.18.243.11:30084(政务外网) | 适用【宜兴政企通-政务外网】 |
6 | 江苏政企通 | 测试 | https://test-gov-authorize-jszqt.eazytec-cloud.com | 适用【江苏政企通】 |
7 | 江苏政企通 | 线上 | https://gov-authorize-jszqt.eazytec-cloud.com | 适用【江苏政企通】 |
审批执法一体化政企通
domain-com企业端说明
序号 | 系统 | 环境 | 地址 | 备注 |
---|---|---|---|---|
1 | 审批执法-江苏省 | 线上 | https://company-api.jsspzf.com/com | 适用【审批执法一体化:江苏省】 |
1 | 审批执法-新吴 | 线上 | http://36.156.152.86:8083/com | 临时开放的互联网地址,后期会有互联网域名和政务外网ip之分 |
domain-gov政府端说明
序号 | 系统 | 环境 | 地址 | 备注 |
---|---|---|---|---|
1 | 审批执法-江苏省 | 线上 | https://gov-api.jsspzf.com/gov | 适用【审批执法一体化:江苏省】 |
1 | 审批执法-新吴 | 线上 | http://36.156.152.86:8085/gov | 临时开放的互联网地址,后期会有互联网域名和政务外网ip之分 |
基本接口
企业端基本接口
序号 | 接口详情 | 地址 |
---|---|---|
1.1 | 企业端-根据clientid和clientSecret获取token | {domain-com}/oauth/token |
1.2 | 企业端-根据用户名密码获取token | {domain-com}/oauth/token |
1.3 | 企业端-认证 | {domain-com}/oauth/authorize |
1.4 | 企业端-刷新token | {domain-com}/oauth/token |
1.5 | 企业端-删除token(token过期) | {domain-com}/oauth/authorize |
1.6 | 企业端-获取登录用户的信息 | {domain-com}/me |
1.7 | 企业端-根据用户id获取用户信息 | {domain-com}/v2/user/getUser |
1.8 | 企业端-app端获取登录用户的加密CODE | {domain-com}/v3/user/code/enc |
1.9 | 企业端-app端解密用户加密CODE获取userId | {domain-com}/v3/user/code/dec |
1.10 | 企业端-pc端解密用户加密CODE获取userId | {domain-com}/active/user/code/dec |
1.11 | 企业端-根据用户username获取用户信息 | {domain-com}/me/{usrname} |
政府端基本接口
序号 | 接口详情 | 地址 |
---|---|---|
2.1 | 政府端-根据clientid和clientSecret获取token | {domain-gov}/oauth/token |
2.2 | 政府端-根据用户名和密码获取token | {domain-gov}/oauth/token |
2.3 | 政府端-认证 | {domain-gov}/oauth/authorize |
2.4 | 政府端-刷新token | {domain-gov}/oauth/authorize |
2.5 | 政府端-删除token(token过期) | {domain-gov}/oauth/authorize |
2.6 | 政府端-获取登录用户的信息 | {domain-gov}/me |
2.7 | 政府端-根据用户id获取用户信息 | {domain-gov}/v2/me/{userId} |
2.8 | 政府端-app端获取登录用户的加密CODE | {domain-gov}/v3/user/code/enc |
2.9 | 政府端-app端解密用户加密CODE获取userId | {domain-gov}/v3/user/code/dec |
2.10 | 政府端-pc端解密用户加密CODE获取userId | {domain-gov}/active/user/code/dec |
2.11 | 政府端-根据用户username获取用户信息 | {domain-gov}/me/{usrname} |
1.1 企业端-根据clientid和clientSecret获取token
请求URL
{domain-com}/oauth/token
请求方式
POST
请求header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Content-Type | String | application/x-www-form-urlencoded | 是 |
- 请求Body参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
grant_type | String | client_credentials | 是 |
client_id | String | XXXXXX | 是 |
client_secret | String | XXXXXX | 是 |
- 返回
返回成功
{ "access_token": "XXXXXX", "token_type": "bearer", "expires_in": 981, "scope": "read get_user_info get_label_relation get_address get_application admin:label write:label read:label admin:user read:user write:user admin:dept read:dept write:dept read:company:basic read:safety" }
1.2 企业端-根据用户名密码获取token
请求URL
{domain-com}/oauth/token
请求方式
POST
请求header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Content-Type | String | application/x-www-form-urlencoded | 是 |
- 请求Body参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
grant_type | String | password | 是 |
client_id | String | XXXXXX | 是 |
client_secret | String | XXXXXX | 是 |
username | String | XXXXXX | 是 |
password | String | XXXXXX | 是 |
- 返回
返回成功
{ "access_token": "XXXXXX", "token_type": "bearer", "expires_in": 981, "scope": "read get_user_info get_label_relation get_address get_application admin:label write:label read:label admin:user read:user write:user admin:dept read:dept write:dept read:company:basic read:safety" }
1.6 企业端-获取登录用户的信息
请求URL
{domain-com}/me
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
注意
本接口的token是通过1.2接口返回获取的
- 返回
返回成功
{ "userId": "2ef14a97-99d7-4d07-956d-0de127bfa3fc", "username": "13861503021", "realname": "於晓荻", "avatar": "https://gateway.eazytec-cloud.com/EFS_gcs/gov/mine/images/20181030/userPortrait_1540882438082_ed6ae932-20e2-49c3-8c8d-a1f4dcb2e3ad.jpg", "phone": "13861503021", "email": "214125777@163.com", "sex": null, "locked": 0, "ctime": 1528980250917, "lastLoignTime": 1540888660393, "systemId": "97719c1d-85af-4ad2-a955-2df7ea1684e9", "userType": "1", "companyId": 1, "isAdmin": "0", "isMasterAdmin": "0", "deptCode": "", "imId": "b3aea0ab-c88c-45e2-9beb-41e72fc58a16", "baseId": "5cce822c-9560-4ba2-90e5-8577fb14ad41", "isIm": null, "orders": null, "landlinePhone": null, "duty": null, "office": null, "weixin": null, "qq": null, "enabled": false, "accountNonExpired": false, "credentialsNonExpired": false, "accountNonLocked": false }
1.7 企业端-根据用户id获取用户信息
请求URL
{domain-com}/v2/user/getUser
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
userId | String | 30f7b505-408a-491e-917a-0b82731ee6c7 | 是 |
baseId | String | 53bc8f43-98f9-4c0f-a4ed-e88f323cc1aa | 是 |
- 返回
返回成功
{ "data": { "accountNonExpired": false, "accountNonLocked": false, "avatar": "https://gateway.eazytec-cloud.com/EFS_gcs/gov/mine/images/20181024/userPortrait_1540344076506_5c109702-bf15-4a8a-aeef-62060b5b9907.jpg", "credentialsNonExpired": false, "ctime": 1525342880651, "enabled": false, "imId": "10", "lastLoignTime": 1541660172722, "locked": 0, "password": "75b89a6e5681ceef57c15896f1c4a2c6f4df31c1", "phone": "15896487568", "realname": "毛达伟", "sex": 1, "systemId": "97719c1d-85af-4ad2-a955-2df7ea1684e9", "userId": "30f7b505-408a-491e-917a-0b82731ee6c7", "userType": "1", "username": "15896487568" }, "msg": "success", "status": 200 }
1.8 企业端-app端获取登录用户的加密CODE
请求URL
{domain-com}/v3/user/code/enc
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
注意
本接口的token是通过1.2接口返回获取的
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
clientId | String | zqtong_app_client | 是 |
- 返回
返回成功
{ "data": "Z%23B0n%2FdSsGWsjhmbt%23GfnBarS5otAyX8ehAHfcrnuVaMfteMifFTeyzDaa%2F62qDx2Vz5qDc08dqL%0ABPaK%230PoMn01jeEjCLI4XABJW%23G%232e8%3D", "msg": "success", "status": 200 }
注意
1. 返回的Data即为加密后的CODE,使用有限期为1分钟 2. 返回的CODE已经过urlEncode,http get传输时要注意
1.9 企业端-app端解密用户加密CODE获取userId
请求URL
{domain-com}/v3/user/code/dec
请求方式
GET
请求Header参数
| 参数 | 格式 | 举例 | 是否必须 | | :----- | :----- | :----- | :----- | | Authorization | String | Bearer XXXXXX | 是 |
注意
本接口的token是通过1.1接口返回获取的(根据clientId获取的token)
请求Query参数
| 参数 | 格式 | 举例 | 是否必须 | | :----- | :----- | :----- | :----- | | clientId | String | zqtong_app_client| 是 | | code | String | 用户加密code| 是 |
注意
若CODE已在http get传输时urldecode,调用本接口时一定要记得先进行urlencode
返回
返回成功
{ "data": "{userId}", "msg": "success", "status": 200 }
返回失败:code过期
{ "data": "user code is expired!", "msg": "user code is expired!", "status": 600 }
返回失败:code无效
{ "data": "user code is invalid!", "msg": "user code is invalid!", "status": 600 }
1.10 企业端-pc端解密用户加密CODE获取userId
请求URL
{domain-com}/active/user/code/dec
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
code | String | 用户加密code | 是 |
- 返回
返回成功
{ "data": "{userId:baseId}", "msg": "success", "status": 200 }
返回失败:参数异常
{ "data": "参数异常", "msg": "参数异常", "status": 400 }
返回失败:服务器内部错误
{ "data": "服务器内部错误", "msg": "服务器内部错误", "status": 500 }
1.11 企业端-根据用户usrname获取用户信息
请求URL
{domain-com}/me/username
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
- 返回
返回成功
{ "userId": "2ef14a97-99d7-4d07-956d-0de127bfa3fc", "username": "13861503021", "realname": "於晓荻", "avatar": "https://gateway.eazytec-cloud.com/EFS_gcs/gov/mine/images/20181030/userPortrait_1540882438082_ed6ae932-20e2-49c3-8c8d-a1f4dcb2e3ad.jpg", "phone": "13861503021", "email": "214125777@163.com", "sex": null, "locked": 0, "ctime": 1528980250917, "lastLoignTime": 1540888660393, "systemId": "97719c1d-85af-4ad2-a955-2df7ea1684e9", "userType": "1", "companyId": 1, "isAdmin": "0", "isMasterAdmin": "0", "deptCode": "", "imId": "b3aea0ab-c88c-45e2-9beb-41e72fc58a16", "baseId": "5cce822c-9560-4ba2-90e5-8577fb14ad41", "isIm": null, "orders": null, "landlinePhone": null, "duty": null, "office": null, "weixin": null, "qq": null, "enabled": false, "accountNonExpired": false, "credentialsNonExpired": false, "accountNonLocked": false }
2.1 政府端-根据clientid和clientSecret获取token
请求URL
{domain-gov}/oauth/token
请求方式
POST
请求header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Content-Type | String | application/x-www-form-urlencoded | 是 |
- 请求Body参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
grant_type | String | client_credentials | 是 |
client_id | String | XXXXXX | 是 |
client_secret | String | XXXXXX | 是 |
- 返回
返回成功
{ "access_token": "XXXXXX", "token_type": "bearer", "expires_in": 7199, "scope": "read get_user_info" }
2.2 政府端-根据用户名和密码获取token
请求URL
{domain-gov}/oauth/token
请求方式
POST
请求header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Content-Type | String | application/x-www-form-urlencoded | 是 |
- 请求Body参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
grant_type | String | password | 是 |
client_id | String | XXXXXX | 是 |
client_secret | String | XXXXXX | 是 |
username | String | XXXXXX | 是 |
password | String | XXXXXX | 是 |
- 返回
返回成功
{ "access_token": "XXXXXX", "token_type": "bearer", "expires_in": 7199, "scope": "read get_user_info" }
2.6 政府端-获取登录用户的信息
请求URL
{domain-gov}/me
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer 7bf84c83-3c25-4b08-896c-6cf20c4778cd | 是 |
注意
本接口的token是通过2.2接口返回获取的
- 返回
返回成功
{ "userId": "2ef14a97-99d7-4d07-956d-0de127bfa3fc", "username": "13861503021", "realname": "於晓荻", "avatar": "https://gateway.eazytec-cloud.com/EFS_gcs/gov/mine/images/20181030/userPortrait_1540882438082_ed6ae932-20e2-49c3-8c8d-a1f4dcb2e3ad.jpg", "phone": "13861503021", "email": "214125777@163.com", "sex": null, "locked": 0, "ctime": 1528980250917, "lastLoignTime": 1540889217050, "systemId": "97719c1d-85af-4ad2-a955-2df7ea1684e9", "userType": "1", "companyId": 1, "isAdmin": "0", "isMasterAdmin": "0", "deptCode": "", "imId": "b3aea0ab-c88c-45e2-9beb-41e72fc58a16", "baseId": "5cce822c-9560-4ba2-90e5-8577fb14ad41", "isIm": null, "orders": null, "landlinePhone": null, "duty": null, "office": null, "weixin": null, "qq": null, "enabled": false, "accountNonExpired": false, "credentialsNonExpired": false, "accountNonLocked": false }
2.7 政府端-根据用户id获取用户信息
请求URL
{domain-gov}/v2/me/{userId}
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
userId | String | 030cf1fd-9e07-434d-b7a6-55eb5207d97c | 是 |
- 返回
返回成功
同/me
2.8 政府端-获取登录用户的加密CODE
请求URL
{domain-gov}/v3/user/code/enc
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
注意
本接口的token是通过2.2接口返回获取的
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
clientId | String | zqtong_app_client | 是 |
- 返回
返回成功
{ "data": "Z%23B0n%2FdSsGWsjhmbt%23GfnBarS5otAyX8ehAHfcrnuVaMfteMifFTeyzDaa%2F62qDx2Vz5qDc08dqL%0ABPaK%230PoMn01jeEjCLI4XABJW%23G%232e8%3D", "msg": "success", "status": 200 }
注意
1. 返回的Data即为加密后的CODE,使用有限期为1分钟 2. 返回的CODE已经过urlEncode,http get传输时要注意
2.9 政府端-解密用户加密CODE获取userId
请求URL
{domain-gov}/v3/user/code/dec
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
注意
本接口的token是通过2.1接口返回获取的(根据clientId获取的token)
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
clientId | String | zqtong_app_client | 是 |
code | String | 用户加密code | 是 |
注意
若CODE已在http get传输时urldecode,调用本接口时一定要记得先进行urlencode
- 返回
返回成功
{ "data": "{userId}", "msg": "success", "status": 200 }
返回失败:code过期
{ "data": "user code is expired!", "msg": "user code is expired!", "status": 600 }
返回失败:code无效
{ "data": "user code is invalid!", "msg": "user code is invalid!", "status": 600 }
2.10 政府端-pc端解密用户加密CODE获取userId
请求URL
{domain-gov}/active/user/code/dec
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer XXXXXX | 是 |
- 请求Query参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
code | String | 用户加密code | 是 |
- 返回
返回成功
{ "data": "{userId:clientId}", "msg": "success", "status": 200 }
返回失败:参数异常
{ "data": "参数异常", "msg": "参数异常", "status": 400 }
返回失败:服务器内部错误
{ "data": "服务器内部错误", "msg": "服务器内部错误", "status": 500 }
2.11 政府端-根据用户username获取用户信息
请求URL
{domain-gov}/me
请求方式
GET
请求Header参数
参数 | 格式 | 举例 | 是否必须 |
---|---|---|---|
Authorization | String | Bearer 7bf84c83-3c25-4b08-896c-6cf20c4778cd | 是 |
- 返回
返回成功
{ "userId": "2ef14a97-99d7-4d07-956d-0de127bfa3fc", "username": "13861503021", "realname": "於晓荻", "avatar": "https://gateway.eazytec-cloud.com/EFS_gcs/gov/mine/images/20181030/userPortrait_1540882438082_ed6ae932-20e2-49c3-8c8d-a1f4dcb2e3ad.jpg", "phone": "13861503021", "email": "214125777@163.com", "sex": null, "locked": 0, "ctime": 1528980250917, "lastLoignTime": 1540889217050, "systemId": "97719c1d-85af-4ad2-a955-2df7ea1684e9", "userType": "1", "companyId": 1, "isAdmin": "0", "isMasterAdmin": "0", "deptCode": "", "imId": "b3aea0ab-c88c-45e2-9beb-41e72fc58a16", "baseId": "5cce822c-9560-4ba2-90e5-8577fb14ad41", "isIm": null, "orders": null, "landlinePhone": null, "duty": null, "office": null, "weixin": null, "qq": null, "enabled": false, "accountNonExpired": false, "credentialsNonExpired": false, "accountNonLocked": false }