V2
获取当前身份
获取当前 token 对应的 bot_user 身份信息。
获取当前身份
适用场景
当你想确认当前 token 代表的是哪一个集成身份时，使用这个接口。它适合做连通性检查，也适合在请求日志里对齐当前 token 的实际归属。
接口信息
| 项目 | 内容 |
|---|---|
| 方法 | GET |
| 路径 | /v2/users/me |
| 请求体 | 无 |
| 返回 | bot_user |
| Scope | 无额外要求 |
权限要求
只需要一个有效 token，不额外要求读写 scope。返回的是当前 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"
}行为说明
- 这个接口返回的是当前 token 的
bot_user身份，不会返回创建者本人的user对象。 - 如果 token 是 OAuth token，响应结构仍然是
bot_user。 - 这个接口适合先验证 token 是否可用，再决定是否调用其他需要 scope 的接口。
错误提示
401 unauthorized：token 无效或已过期。403 forbidden：空间不可用或 token 被拒绝访问。