查询

地址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&timestamp=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"
}

接口错误解决方案

通用错误解决文档

  1. 4xx 错误
  2. 1xxx 错误

results matching ""

    No results matching ""