查询

优质

小牛编辑

129浏览

2023-12-01

地址URL

https://api.es.xiaojukeji.com/river/BudgetCenter/get

返回数据格式

JSON

请求方式

GET

是否需要登录

是关于登录授权，参见如何登录授权

访问授权限制

暂无

请求参数

名称	类型	必选	描述
client_id	string	yes	申请应用时分配的AppKey
access_token	string	yes	授权后的access token
timestamp	int	yes	当前时间戳，精确到秒级
company_id	bigint	yes	企业ID
sign	string(32)	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	名称
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是）；当类型为项目时，此参数有效
start_date	string	项目开始日期；当类型为项目时，此参数有效
expiry_date	string	项目结束日期；当类型为项目时，此参数有效

返回示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "total":32,
        "records":[
            {
                "id":"6388733755640532997",
                "name":"openapi1452169149",
                "company_id":"4591398120721764364",
                "status":"0",
                "out_budget_id":"0",
                "type":"1",
                "budget_cycle":"1",
                "is_limit_quota":"1",
                "member_num":"0",
                "total_quota":"1000.00",
                "available_quota":"1000.00",
                "freeze_quota":"0.00"
            }
        ]
    }
}

接口错误解决方案

通用错误解决文档

4xx 错误
1xxx 错误