Forward Vault API 复用的响应结构。
Vault 对象
创建、查询、列表、归档接口都会返回该结构。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Vault ID，前缀为 vault_ |
type | string | 固定值 "vault" |
display_name | string | Vault 展示名称，最长 255 字符 |
metadata | object | 与 Vault 一起存储的自定义元数据对象；省略时为 {}。created_by 为 Forward 保留字段，调用方不可传入 |
archived_at | string | null | 归档时间，RFC 3339 格式；active 时为 null |
created_at | string | 创建时间，RFC 3339 格式 |
updated_at | string | 最后更新时间，RFC 3339 格式 |
identity_id | string | null | Forward 归属身份；PAT 创建时通常为 null |
icon_url | string | null | Forward 关联的 icon URL |
binding_info | Binding info | 绑定信息（Template 引用计数等） |
Binding info
Forward 在 Vault 响应中携带的引用聚合。
| 字段 | 类型 | 说明 |
|---|---|---|
agent_template_count | integer | 当前绑定该 Vault 的 Template 数量 |
列表分页字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | Vault 对象 数组 | 当前页记录 |
has_more | boolean | 是否还有下一页 |
next_page | string | null | 下一页向后游标（推荐使用）；has_more=true 时等于当前页 last_id，否则为 null |
first_id | string | null | 当前页第一条记录 ID |
last_id | string | null | 当前页最后一条记录 ID |
page / after_id / before_id 互斥，同时提供多个返回 400；推荐使用 page，语义等价于 after_id。