调用方 Key 的身份及其可执行的操作。
读取当前身份
GET/v2/whoami
当前主体、正在使用的 Key 和有效能力。不需要任何能力,因此失去全部能力的 Key 仍可查看自己剩余的能力。
需要的能力 不检查能力。
指南:认证与 API Key
响应
200application/jsonDevWhoami
错误状态
400 401 403 404 422 429 500 503 错误结构见 错误,各错误码的含义见 错误码。
请求示例
curl "https://api.mirabase.dev/v2/whoami" \
-H "Authorization: Bearer $MIRABASE_API_KEY"响应结构示例
{
"tenant_id": "<tenant_id>",
"principal": {
"id": "<id>",
"kind": "human",
"roles": [
"<roles>"
],
"capabilities": [
"knowledge:read"
],
"created_at": "2026-11-06T00:00:00Z"
},
"effective_capabilities": [
"knowledge:read"
]
}