用飞书资料填充我的个人资料

POST /api/v1/me/feishu-profile-sync · syncMyFeishuProfile

把当前用户在指定项目已绑定的飞书身份（显示名 / 头像）主动同步进中央个人资料（修复规格「已锁产品决策 3」）。同步后这些值成为自定义资料，后续飞书侧变化不会自动覆盖，想更新需再次同步。要求该项目已配置飞书且本人已绑定，否则 422。与 PATCH /me/profile 的头像校验不同：这里的头像来自我们在 OAuth 时已抓取、属于用户本人的飞书 CDN 地址，是可信来源的复制，不是用户任意输入，故允许外链。

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

请求体

projectId（必填）: string

响应字段 · 200

userId（必填）: string
email（必填）: string
emailVerified（必填）: boolean
orgs（必填）: OrgSummary[]
orgs[].id（必填）: string
orgs[].name（必填）: string
orgs[].role（必填）: enum；取值：admin / member
lastActiveOrgId: string
hasCreatedOrg（必填）: boolean
displayName: string
avatarUrl: string
avatarSource: enum；取值：custom / feishu / none
platformRole（必填）: enum；取值：user / superadmin

错误

401：Problem 错误响应
422：Problem 错误响应

请求示例（curl）

curl -X POST "https://workflow.games/api/v1/me/feishu-profile-sync" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"projectId":"018f3c2e-0000-7000-8000-000000000000"}'

响应示例

HTTP/1.1 200
{
  "userId": "018f3c2e-0000-7000-8000-000000000000",
  "email": "[email protected]",
  "emailVerified": true,
  "orgs": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "role": "admin"
    }
  ],
  "hasCreatedOrg": true,
  "platformRole": "user"
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引