v1auth 上下文
安全记录
GET /v1/auth/audit-logs：账号上发生过什么。
安全记录回答的是「我自己账号上发生过什么」：改密、换凭据、踢会话、撤授权，以及每次尝试的结果与来源。
请求
GET /v1/auth/audit-logs，会话令牌，受众 auth。
| 查询参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 可选 | 默认 20，上限 100 |
cursor | string | 可选 | 上一页返回的游标 |
响应
{
"success": true,
"entries": [
{
"id": "aud_...",
"action": "password.change",
"title": "Password changed",
"outcome": "success",
"ip": "203.0.113.7",
"country": "JP",
"user_agent": "Mozilla/5.0 ...",
"created_at": "2026-11-14T08:40:00.000Z"
}
],
"next_cursor": null
}| 字段 | 说明 |
|---|---|
action | 机器可读的动作标识 |
title / description | 由 action 派生的展示文案 |
outcome | 只有 success 与 failure 两种 |
ip / country / user_agent | 本次操作的来源 |
失败原因不下发
服务端只回「成功/失败」，不回具体失败原因：那是攻击面画像，对本人没有帮助，对攻击者很有帮助。
规则
| 规则 | 说明 |
|---|---|
| 只接受会话令牌 | OAuth 客户端没有理由读到用户在别处改密码的历史 |
| 只读，不要求提权 | 用户查自己的记录不会造成破坏；加 max_age 只会让「刚收到可疑登录提醒、想立刻看看」变成「先去重新认证」 |
| 按时间倒序 | 最新的在最前，翻页用 cursor |