新增

请求地址

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

返回数据格式

JSON

请求方式

POST

是否需要登录

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

访问授权限制

暂无

请求参数

名称 类型 必选 描述
client_id string yes 申请应用时分配的AppKey
access_token string yes 授权后的access token
timestamp int yes 当前时间戳,精确到秒级
company_id bigint yes 企业ID
sign string(32) yes 签名
name string yes 名称
type int yes 类型(1部门 2项目)
budget_cycle int yes 预算周期(0不限期;1自然月)
total_quota float yes 总金额(0表示不限额度,单位元,小数点后保留两位精度)
out_budget_id string no 编号(部门为必填,项目为选填)
leader_id string no 主管,通过员工-详情API获得对应id
parent_id int no 上级部门或项目的id(部门为选填,默认为顶级部门的id;项目为选填)
member_used int no 是否仅项目成员可用(0不是;1是)默认为0;当类型为项目时,此参数有效
start_date string no 项目开始日期(格式举例:2018-01-02),可以为空;当类型为项目时,此参数有效
expiry_date string no 项目结束日期(格式举例:2018-01-02),可以为空;当类型为项目时,此参数有效

注意事项

  1. 部门数量上限是2000,如贵司超过2000个部门,请联系相应的对接同学添加白名单进行扩展
  2. 部门添加时,请不要并发操作,防止部门添加失败

请求示例

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"1e79178d3bfeb40be24404a3048f541f34dd6268","timestamp":1583484681,"company_id":"12345678980","name":"\u56fd\u5e86\u884c\u52a8","type":2,"budget_cycle":1,"total_quota":0,"sign":"b517f48fcbe57a2d66dcefd560452da1"}' \
https://api.es.xiaojukeji.com/river/BudgetCenter/add

返回参数说明

名称 类型 描述
errno string 0表示成功,非0表示失败
errmsg string errno=0时为常量"SUCCESS",errno!=0时为错误信息
data object 部门或项目数据
data.id string 部门或项目id

返回示例

{
    "errno":0,
    "errmsg":"success",
    "data":{
        "id":"6415496924215922706"
    }
}

接口错误解决方案

通用错误解决文档

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

results matching ""

    No results matching ""