API 参考 / feishu-integrations

飞书事件回调入口

POST /api/v1/integrations/feishu/{integrationId}/events · handleFeishuIntegrationEvent

企业自建应用事件订阅回调入口。该端点不走 GameFlow session/PAT 鉴权，改由飞书 X-Lark-Signature / token / Encrypt Key 解密校验；只处理已绑定群里 @机器人 的消息。

公开端点，无需鉴权。

参数

integrationId（必填）

string

响应字段 · 200

ok（必填）

boolean

challenge

string —— URL verification challenge；普通事件处理时为空。

错误

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

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/integrations/feishu/{integrationId}/events" \
  -H "content-type: application/json" \
  --data '{}'

响应示例

HTTP/1.1 200
{
  "ok": true,
  "challenge": "示例文本"
}

合同真值：OpenAPI 3.1（0.1.0）。

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