员工限额接口查询
员工限额查询接口
地址URL
https://api.es.xiaojukeji.com/river/Member/getQuota
支持格式
Json
HTTP请求方式
GET
是否需要登录
是 关于登录授权，参见 如何登录授权
访问授权限制
暂无
请求参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| client_id | string | yes | 申请应用时分配的AppKey |
| access_token | string | yes | 授权后的access token |
| timestamp | bigint | yes | 当前时间戳，精确到秒级 |
| company_id | string | yes | 企业ID |
| member_ids | string | yes | 员工ID，多条员工id使用英文逗号分隔，最多50条 |
| start_date | string | no | 开始日期（如：2020-05-01） |
| end_date | string | no | 结束日期（如：2020-07-31） |
| sign | string | yes | 签名 |
注意事项
1、限额查询请求的开始日期和结束日期时间跨度不能大于六个月。若只传开始日期，则返回结果为开始日期后当月；若只传结束日期，则返回结果为结束日期当月；
2、按指定类型返回对应查询日期内的限额信息；
3、若限额类型为自然月，开始、结束日期应传自然月开始日、结束日；若未传自然月开始日、结束日，则按自然月查询（只取年+月份），如：2020-05-03 至 2020-06-22，则按照2020-05-01 至 2020-06-31查询；
返回参数说明
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| errno | string | 0表示成功，非0表示失败 |
| errmsg | string | errno=0时为常量"SUCCESS"，errno!=0时为错误信息 |
| data | object | 员工额度信息 |
data数据格式：以member_id为key的集合
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| member_id | bigint | 员工在滴滴企业平台的ID |
| quota_start_date | string | 限额开始日期（月限额时为自然月开始日） |
| quota_end_date | string | 限额结束日期（月限额时为自然月结束日） |
| quota_cycle | int | 限额类型（0不限期 1自然月 ） |
| total_quota | float | 总限额(单位：元) |
| available_quota | float | 可用额度(单位：元) |
返回值示例
{
"errno":0,
"errmsg":"SUCCESS",
"data":{
"1125908561679034":[
{
"member_id":1125908561679034,
"quota_start_date":"2021-03-01",
"quota_end_date":"2021-03-31",
"quota_cycle":1,
"total_quota":130,
"available_quota":130
},
{
"member_id":1125908561679034,
"quota_start_date":"2021-04-01",
"quota_end_date":"2021-04-30",
"quota_cycle":1,
"total_quota":140,
"available_quota":140
},
{
"member_id":1125908561679034,
"quota_start_date":"2021-05-01",
"quota_end_date":"2021-05-31",
"quota_cycle":1,
"total_quota":140,
"available_quota":140
}
]
}
}
[2]: [../oauth/auth.md]:
[../oauth/auth.md]: