# 身份

调用方 Key 的身份及其可执行的操作。

API 参考。Base URL：`https://api.mirabase.dev`

## 读取当前身份

`GET /v2/whoami`

当前主体、正在使用的 Key 和有效能力。不需要任何能力，因此失去全部能力的 Key 仍可查看自己剩余的能力。

**需要的能力** 不检查能力。

指南：[认证与 API Key](https://mirabase.io/zh/developers/authentication.md#whoami)

### 响应

- `200` `application/json` `DevWhoami`

### 错误状态

`400` `401` `403` `404` `422` `429` `500` `503` 错误结构见 [错误](https://mirabase.io/zh/developers/conventions.md#errors)，各错误码的含义见 [错误码](https://mirabase.io/zh/developers/errors.md)。

### 请求示例

```bash
curl "https://api.mirabase.dev/v2/whoami" \
  -H "Authorization: Bearer $MIRABASE_API_KEY"
```

### 响应结构示例

```json
{
  "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"
  ]
}
```
