建立部门与单位的绑定关系

POST

/open-apis/contact/v3/unit/bind_department

通过该接口建立部门与单位的绑定关系。由于单位是旗舰版付费功能，企业需开通相关版本，否则会绑定失败，不同版本请参考飞书版本对比

错误码

HTTP状态码	错误码	描述	排查建议
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	43050	unit feature is prohibited	单位是旗舰版功能，需企业开通相应版本
400	43051	unit_id invalid	非法的单位ID
400	43058	department_id invalid	无效非法的部门ID
400	43054	department has been bound to other unit	部门已经绑定其它单位，部门只能绑定一个单位
403	40004	no dept authority error	操作的部门需在通讯录权限范围中，了解更多

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/contact/v3/unit/bind_department' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unit_id": "BU121",
    "department_id": "od-4e6ac4d14bcd5071a37a39de902c7141",
    "department_id_type": "open_department_id"
}'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

unit_id

string

必需

单位ID 示例值："BU121"

department_id

string

必需

单位关联的部门ID 示例值："od-4e6ac4d14bcd5071a37a39de902c7141"

department_id_type

string

可选

此次调用中使用的部门ID的类型示例值："open_department_id" 可选值有： department_id：以自定义department_id来标识部门 open_department_id：以open_department_id来标识部门默认值：open_department_id

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-01-12 07:02:37

修改单位信息

解除部门与单位的绑定关系

建立部门与单位的绑定关系

错误码#

请求参数

返回响应

错误码