API 参考 / feishu-integrations

查询本人飞书身份绑定状态

GET /api/v1/projects/{projectId}/integrations/feishu/identity · getMyFeishuIdentity

返回当前登录用户在本项目飞书集成下的绑定状态（是否已绑定 + 脱敏摘要 + 飞书 profile 展示字段）。 open_id 不回显——仅返回是否绑定、脱敏前缀、displayName/avatarUrl。需要 view_project，且只能查询本人。

鉴权：项目 API Token（Authorization: Bearer wfp_…）。详见 Agent 接入。

参数

state（必填）: enum —— 绑定态三值（从 token 有效性派生）：unbound=未绑定；bound=已绑定且可用；invalid=曾绑定但飞书私信投递被永久拒绝（open_id 失效/应用不可达），需重新绑定。；取值：unbound / bound / invalid
openIdMasked: string —— 脱敏后的 open_id 前缀（如 "ou_abc1****"）；未绑定时为空字符串。
displayName: string —— 飞书用户名；未绑定或飞书未返回时为空字符串。
avatarUrl: string —— 飞书头像 URL；未绑定或飞书未返回时为空字符串。
boundAt: string —— 绑定时间（ISO 8601）；未绑定时为空字符串。

curl -X GET "https://你的项目.workflow.games/api/v1/projects/{projectId}/integrations/feishu/identity" \
  -H "Authorization: Bearer wfp_…"

HTTP/1.1 200
{
  "state": "unbound",
  "openIdMasked": "示例文本",
  "displayName": "示例标题"
}