校验 API Key
GET/openapi/v1/me
需要权限:任意有效 Key
返回当前 Key 的身份与权限范围。建议接入时第一个调它 —— 先确认 Key 可用,再去调业务端点,后面出错时才能判断是参数的问题。
任意有效的 Key 都能调
本端点不校验具体权限 —— 只要 Key 有效就能查到它的权限范围,不会因为权限不足而查不出自己有哪些权限。
请求参数
本端点不需要参数。
响应
下列字段位于 data 之下。
| 字段 | 类型 | 说明 |
|---|---|---|
| user_id | string | 这把 Key 属于哪个账号 |
| key_id | string | Key 的 ID,与控制台列表对得上 |
| scopes | string[] | 权限范围。["*"] 表示全部权限 |
可能的错误
| code | HTTP | 含义与处置 |
|---|---|---|
| 1001 | 401 | Key 无效、已吊销或已过期 |
