查询
地址URL
https://api.es.xiaojukeji.com/river/BudgetCenter/get
返回数据格式
JSON
请求方式
GET
是否需要登录
是 关于登录授权,参见 如何登录授权
访问授权限制
暂无
请求参数
名称 | 类型 | 必选 | 描述 |
client_id | string | yes | 申请应用时分配的AppKey |
access_token | string | yes | 授权后的access token |
timestamp | bigint | yes | 当前时间戳,精确到秒级 |
company_id | string | yes | 企业ID |
sign | string | yes | 签名 |
id | string | no | id |
name | string | no | 名称 |
type | int | no | 类型(1部门 2项目),默认为全部 |
is_exact_name | int | no | 是否精确查询名称(0-否,1-是,默认为0) |
out_budget_id | string | no | 编号(外部成本中心id) |
offset | int | yes | 数据开始位置 |
length | int | yes | 数据条数(最大100条) |
注意事项
请求示例
curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/BudgetCenter/get?client_id=client_id_test&access_token=141ea31466478eab2f1c1ddcca2675b989a16552×tamp=1566764837&id=1125904357323169&company_id=12345678980&offset=0&length=100&sign=fba8dfb887afe16cb71c50b26a5eae0e
返回参数说明
返回值字段 | 字段类型 | 字段说明 |
errno | string | 0表示成功,非0表示失败 |
errmsg | string | errno=0时为常量"SUCCESS",errno!=0时为错误信息 |
data | object | 员工列表信息 |
data数据格式
返回值字段 | 字段类型 | 字段说明 |
total | int | 此次查询符合条件的部门或项目总数 |
records | array | 部门或者项目集合 |
records数组元素格式
名称 | 类型 | 描述 |
---|---|---|
id | string | id |
name | string | 名称 |
company_id | string | 滴滴侧公司 ID |
status | string | 状态 1:启用中;2:停用;3:删除 |
type | int | 类型(1部门 2项目) |
budget_cycle | int | 预算周期(0不限期;1自然月) |
out_budget_id | string | 外部成本中心id |
total_quota | number | 总金额(0表示不限额度) |
is_limit_quota | int | 是否限额(0不限制,1限制) |
member_num | int | 在使用人数 |
available_quota | number | 可用金额 |
freeze_quota | number | 冻结金额 |
leader_id | string | 主管 |
parent_id | int | 上级部门或项目的id |
member_used | int | 0:全员可见,1:项目成员可见,2:公司主体可见 |
start_date | string | 项目开始日期;当类型为项目时,此参数有效 |
expiry_date | string | 项目结束日期;当类型为项目时,此参数有效 |
legal_entity_id | string | 公司主体ID,多个英文逗号分开 |
create_time | string | 创建时间;秒级时间戳 |
update_time | string | 修改时间;秒级时间戳 |
返回示例
{
"errno": 0,
"errmsg": "SUCCESS",
"data": {
"total": "30",
"records": [
{
"id": "1125924827417380",
"name": "1695799535",
"company_id": "1125910319468282",
"status": "1",
"out_budget_id": "",
"type": "2",
"budget_cycle": 0,
"is_limit_quota": 1,
"member_num": 0,
"total_quota": "1000.00",
"available_quota": "1000.00",
"freeze_quota": "0.00",
"leader_id": "0",
"parent_id": "1125910319468295",
"member_used": 1,
"start_date": "0",
"expiry_date": "0",
"create_time": "1695799535",
"update_time": "1695799535"
}
]
},
"request_id": "mbSxNllrNok6ocDW6LGfFiq0jK0YzClqTNM6B5y1QcLemhJHaOYJtrftofPz+mJF"
}
接口错误解决方案
通用错误解决文档
- 4xx 错误
- 1xxx 错误