V2
首次请求
用一个最小请求完成第一次 FlowUs V2 API 调用并学会定位常见错误。
首次请求
如果你想先确认 token 是否可用，第一步就调用 GET /v2/users/me。这个接口最适合用来做第一次连通性验证，因为它只要求有效 token，不额外要求某个读写 scope。
最小 curl
curl -sS https://api.flowus.cn/v2/users/me \
-H 'Authorization: Bearer <token>'如果你的客户端已经在统一管理请求头，也可以把它拆成更清晰的两部分理解：
- 目标地址：
https://api.flowus.cn/v2/users/me - 认证头：
Authorization: Bearer <token>
成功响应示例
GET /v2/users/me 返回的是当前 token 对应的 bot_user 对象。下面是一个精简响应示例：
{
"object": "bot_user",
"id": "20202020-2020-4020-8020-202020202020",
"name": "FlowUs MCP Integration",
"workspace_id": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
"workspace_name": "演示空间",
"owner": {
"object": "user",
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"
},
"capabilities": {
"pages.read": true,
"pages.write": true,
"blocks.read": true,
"blocks.write": true,
"databases.read": true,
"databases.write": true,
"search.read": true
},
"type": "integration",
"integration_id": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee"
}如果你使用的是 OAuth token，返回结构仍然是 bot_user；请求格式不需要变化。
常见错误排查顺序
401
- 检查
Authorization头是否存在。 - 检查格式是否严格为
Bearer <token>。 - 检查 token 是否拼错、过期或已失效。
- 检查 token 所属工作区是否还存在且未被禁用。
403
- 先确认工作区是否属于免费计划。
- 如果不是免费计划，再看当前请求是不是打到了需要 scope 的接口。
- 如果你已经在调用别的接口，核对 token 的 capabilities 是否能映射出需要的 scope。
GET /v2/users/me 本身只要求有效 token，不额外要求某个读写 scope，所以如果这个接口都返回 403，优先检查空间计划、token 所属空间或访问入口，而不是 scope 本身。