查询授权企业中员工绑定的资产¶
使用场景¶
商家与关爱通合作,员工在给到app中绑定的资产购买商家服务时,商家需要查询指定员工余额的情况; 如果不指定员工,则返回所有绑定过资产的员工金额列表
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/seller/enterprise/queryPersonBindAsset
- 生产环境: https://openapi.guanaitong.com/seller/enterprise/queryPersonBindAsset
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| enterprise_open_id | 是 | string | [10,50] | 32位关爱通企业openid |
| buyer_open_id | 否 | string | [10,50] | 32位关爱通员工openid |
请求示例¶
POST: /seller/enterprise/queryPersonBindAsset HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=b983eef183a789a693b91406f38b7e23×tamp=1529046657&version=1.0.0&enterprise_open_id=77f98fpk40ae3698i03nf79kse1f98ik
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |
| total_count | 企业总员工数 |
| bind_count | 绑定过资产的总员工数 |
| bind_list.username | 员工名称 |
| bind_list.name | 绑定的资产名称 |
| bind_list.buyer_open_id | 32位关爱通员工openid |
| bind_list.balance | 关爱通员工消费应用中可用资产金额 |
| bind_list.asset_code | 资产类型,枚举值【 POINT -> 代表积分,QUOTA -> 代表额度 】 |
| bind_list.asset_open_id | 账户openid |
正确返回示例¶
{
"code": 0,
"data": {
"bind_list": [
{
"username":"张三",
"name": "关爱积分",
"buyer_open_id": "kof08f25d0ae36225281f7378e1fc934",
"balance": 10.45,
"asset_code":"POINT",
"asset_open_id":"94h98fpk40ae3698i03nf79kse1f870e"
},
{
"username":"李四",
"name": "员工午餐",
"buyer_open_id": "36a313c4a9043c6ce698e1e4cb5d2482",
"balance": 934.20,
"asset_code":"QUOTA",
"asset_open_id":"67g98fpk40ae3698i03nf79kse1f870e"
},
{
"username":"王五",
"name": "员工午餐",
"buyer_open_id": "po0l25a9f608938b2c87c8b6d39fi90e",
"balance": 45.06,
"asset_code":"QUOTA",
"asset_open_id":"18u9i3pk40ae3698i03nf79kse1f870e"
}
],
"total_count": 34,
"bind_count": 3
},
"msg": "OK"
}