<!-- 来源: https://hostanagent.com/docs/reference/ | 协议: 1.0 | 更新: 2026-09-30 -->

# API 与协议参考

核对公开 REST、SSE、执行器和错误协议。

## 本组文档

- [地址、身份与权限](/docs/reference/authentication/)：REST `/v1` 与 MCP 地址；Bearer Key、可信 Subject、scope/Agent 范围；网页账号身份与 OAuth；401/403 与资源隔离；公共接口清单入口
- [配置与生命周期 API](/docs/reference/configuration/)：Agent 与工具集配置、revision 和幂等；max_context_tokens 与 max_result_context_bytes；旧字段删除、发布新版本与会话生效步骤
- [会话与运行 API](/docs/reference/runtime/)：capabilities/models/bootstrap/runtime 元数据；Session、历史、Run、追加输入、取消、审批和诊断；逻辑 Agent 与固定版本选择；状态和结束分类
- [SSE 事件与恢复](/docs/reference/events/)：事件信封、sequence、事件类型、展示推理、增量与最终结果、快照/cursor/去重、终态及旧客户端处理未知可选字段
- [执行器与工具回执协议](/docs/reference/tools/)：执行器、claim/grant 与可靠回执；max_result_context_bytes 默认 16 KiB、上限 32 KiB；UTF-8 字节裁剪、完整回执、分页设计与 context_preview 模拟预览
- [错误码、限制与重试](/docs/reference/errors-limits/)：HTTP 状态、稳定错误 code 与安全重试；余额、权限、版本、模型、工具和上下文边界；当前默认值、配置范围及已删除字段
