Skip to content

解除 Exchange 账户绑定

调用该接口解除 Exchange 账户和飞书账户的绑定关系,Exchange 账户解除绑定后才能和其他飞书账户继续绑定。

Tip: 当前身份需要是企业超级管理员。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/calendar/v4/exchange_bindings/:exchange_binding_id
HTTP MethodDELETE
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可calendar:calendar 更新日历及日程信息 calendar:exchange.bindings:delete 删除 Exchange 绑定关系

请求头

名称类型必填描述
Authorizationstringuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
exchange_binding_idstringExchange 绑定的唯一标识 ID。调用 将 Exchange 账户绑定到飞书账户 绑定时,可从返回结果中获取 exchange_binding_id。
示例值:"ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20="

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

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

错误码

HTTP状态码错误码描述排查建议
400190002invalid parameters in request无效的请求参数。排查建议如下: - 确认请求参数的字段名称、传参类型正确。 - 确认已经申请了相应资源的权限。 - 确认相应资源未被删除。
500190003internal service error内部服务错误,请咨询技术支持
429190004method rate limited方法频率限制。建议稍后再试,并适当减小请求 QPS。
429190005app rate limited应用频率限制。建议稍后再试,并适当减小请求 QPS。
403190006wrong unit for app tenant请求错误,检查应用 App ID 和 App Secret 是否正确。如仍无法解决请咨询技术支持
404190007app bot_id not found应用的 bot_id 没有找到。你需要确保应用开启了机器人能力。如仍未解决请咨询技术支持
429190010current operation rate limited当前操作被限流,原因一般为公用资源并发抢占失败。你可以适当降低当前操作频率,然后重试。
404195100user is dismiss or not exist in the tenant当前身份或指定用户已经离职,或者不在该租户内。请检查并改为正确的身份来调用接口。
403195101user is not supper administrator当前身份不是该租户的超级管理员。请检查并修改身份信息。
400195102exchange_binding_id invalidexchange_binding_id 无效。你需要检查并修改为正确的 ID。
404195103exchange account binding is not foundexchange 账户的绑定关系没有找到。你需要检查输入参数是否填写正确。
403195104current tenant not match当前租户与 admin 账户绑定的租户不匹配。你需要检查并修改为正确的参数值。
403195105admin account binding failed管理后台绑定 admin 帐户失败。请在管理后台重新绑定 admin 账户后重试。
404195106admin account is not foundadmin 账户不存在。你需要检查并修改为正确的参数值。

更多错误码信息,参见通用错误码

内容来源:飞书开放平台 · 自动爬取整理