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

POST

/contact/v3/unit/unbind_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
403	40004	no dept authority error	操作的部门需在通讯录权限范围中，了解更多

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/contact/v3/unit/unbind_department' \
--header 'Authorization: Bearer <token>' \
--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": {}
}

修改于 2025-10-20 09:58:21

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

获取单位绑定的部门列表

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

错误码#

请求参数

返回响应

错误码