查看凭证空间列表
更新时间：2026-09-10
GET
https://api.dumate.cn/api/v1/vaults
本接口用于查询凭证空间（Vault）列表，支持游标分页。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
cursor
string
分页游标。
首次请求不传；后续请求传入上一页响应返回的 nextCursor。
可选
limit
integer
每页返回数量。
默认值：20。
最大值：100。
可选
请求结构
GET /api/v1/vaults?limit=20 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/v1/vaults?limit=20" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
凭证空间（Vault）列表。
可选
显示子属性
隐藏子属性
items
object {5}
显示子属性
隐藏子属性
id
string
凭证空间（Vault）标识。
可选
name
string
凭证空间（Vault）名称。
可选
status
string
凭证空间（Vault）状态。
可选值：active：有效。revoked：已删除。
可选
createdAt
string
创建时间，ISO 8601 格式，UTC 时间。
可选
updatedAt
string
最近更新时间，ISO 8601 格式，UTC 时间。
可选
nextCursor
stringnull
下一页游标，取值为本页最后一条记录的 id；无下一页时为 null。
查询下一页时将该值作为请求参数 cursor 传入。
可选
hasMore
boolean
是否还有下一页。true：有下一页。false：已是最后一页。
可选
响应示例
{
"data": [
{
"id": "vault_4564398e316444ee",
"name": "示例业务凭证库",
"status": "active",
"createdAt": "2026-09-03T11:37:19Z",
"updatedAt": "2026-09-03T11:37:19Z"
},
{
"id": "vault_6bb34939f5a54954",
"name": "web_chat_1788418311775",
"status": "active",
"createdAt": "2026-09-03T06:51:52Z",
"updatedAt": "2026-09-03T06:51:52Z"
},
{
"id": "vault_c36522e3318d4519",
"name": "web_chat",
"status": "active",
"createdAt": "2026-09-03T06:36:51Z",
"updatedAt": "2026-09-03T06:36:51Z"
},
{
"id": "vault_66ea2ff414b146f3",
"name": "presales_vault",
"status": "active",
"createdAt": "2026-09-03T04:53:59Z",
"updatedAt": "2026-09-03T04:53:59Z"
}
],
"nextCursor": "vault_8b282b1e28b94e5e",
"hasMore": true
}评价此篇文章