# 查询槽位操作日志

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

读取全部或指定槽位的最新变更摘要。这里只提供最新窗口，没有下一页游标或偏移量。

```text
GET https://api.moi.matrixorigin.cn/v5/admin/aistudio/service-slots/operation-logs
```

## 调用前准备

准备当前环境可用的Genesis管理员Bearer令牌；普通个人访问令牌、X-API-Key或工作区Owner不能替代。会话模式还需相应CSRF，详见[AI Studio](../../../../../developer/api/ai-studio/index.md)。这些是账户级管理操作，不需要工作区ID。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --get "https://api.moi.matrixorigin.cn/v5/admin/aistudio/service-slots/operation-logs" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
  --data-urlencode "slot_id=agent_chat" --data-urlencode "page_size=50"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `Authorization` | string | Bearer示例是 | Bearer加当前环境的管理员令牌；不要同时发送X-API-Key。 |
| `slot_id` | string | 否 | 查询参数，省略或空白为全部；非空须是已注册槽位。 |
| `page_size` | integer | 否 | 查询参数，默认50；非正值按默认，大于200截为200；非整数字符串返回400。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "logs": [
    {
      "id": 1,
      "actor_user_id": "admin-example",
      "actor_name": "Admin",
      "action": "update",
      "slot_id": "agent_chat",
      "summary": "agent_chat: model-example",
      "created_at": 1794456000
    }
  ]
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `logs` | object（对象数组） | 按created_at、id均倒序的最新窗口；没有total或next_cursor。 |
| `logs[].id` | integer | 日志ID。 |
| `logs[].actor_user_id` | string | 可选操作者ID。 |
| `logs[].actor_name` | string | 可选操作者名称。 |
| `logs[].action` | string | 可选动作，当前更新记update。 |
| `logs[].slot_id` | string | 可选槽位标识。 |
| `logs[].summary` | string | 可选变更摘要，不能据此还原完整旧配置。 |
| `logs[].created_at` | integer | Unix时间戳，单位秒。 |

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "ErrForbidden",
  "msg": "Forbidden"
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 当前错误代码。 |
| `msg` | string | 当前失败阶段的说明；该示例为HTTP Forbidden文本。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / ErrParamInvalid | 槽位、模型、默认值、JSON文本或日志数量参数不合法。 |
| 401 / Unauthorized | 身份无效或使用X-API-Key等不适用认证方式。 |
| 403 / ErrForbidden | 无Genesis管理员事实。 |
| 503 / ErrServiceUnavailable | 已分类的必要身份/配置依赖不可用。 |
| 500 / ErrServer或InternalServerError | 内部或身份阶段失败；写入错误后先回读，不能推断回滚。 |

错误使用code/msg，成功却是原始对象。不同失败阶段可能使用不同字符串code；不虚构每个校验错误的独立机器reason。

:::::
::::::
:::::::
