员工账号授权以及撤销授权功能(仅银行卡业务)
- 接口(建议后缀): /employee/authorize
- Method-Type:POST
- 数据格式:Json
- 调用方:每刻
- 接口说明:每刻将通过供应商提供的此接口推送信息,授权以及取消授权。(商旅平台无需对接该接口)
请求参数
参数 |
类型 |
必须 |
描述 |
externalCorpCode |
String |
Y |
企业唯一标识 |
externalEmployeeCode |
String |
Y |
授权账号(如银行卡卡号、员工工号等) |
mobile |
String |
Y |
手机号, 当externalEmployeeCode非手机号 且需要手机号联合授权时给 |
employeeName |
String |
N |
员工姓名 |
identityNo |
String |
N |
持卡人证件号码 |
opType |
String |
Y |
GRANT 、REVOKE (GRANT:授权, REVOKE:取消授权) |
响应结构
参数 |
类型 |
必须 |
描述 |
success |
bool |
Y |
账号授权是否成功 |
errorMessage |
String |
N |
失败信息(当 success 返回为 false, 该字段必填) |
示例
[warning] 重要:
示例维护并非和文档字段维护一样频繁,如果遇到示例和文档不一致,请以文档为准
请求头:
{
"tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}
请求示例:
{
"externalCorpCode" : "MAYCUR",
"externalEmployeeCode" : "6222021234369874563",
"mobile" : "18868888888",
"employeeName" : "张三",
"identityNo" : "330184194910010012",
"opType" : "GRANT"
}
响应示例:
{
"success":true,
"errorMessage": null
}