新增
优质
小牛编辑
121浏览
2023-12-01
请求地址
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），可以为空；当类型为项目时，此参数有效 |
注意事项
- 部门数量上限是2000，如贵司超过2000个部门，请联系相应的对接同学添加白名单进行扩展
- 部门添加时，请不要并发操作，防止部门添加失败
请求示例
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"
}
}
接口错误解决方案
通用错误解决文档
- 4xx 错误
- 1xxx 错误