获取凭证空间列表
更新时间：2026-11-13
GET
https://api.dumate.cn/api/dma/v1/vaults?limit=2
本接口用于分页查询凭证空间（Vault）列表。
返回结果按游标分页：data 为当前页的凭证空间列表，next_page 为下一页游标；没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
limit
integer
每页条数，默认 20，取值 1–100。
超出范围时返回 400。
可选
page
string
翻页游标，取上一页响应的 next_page；第一页不传。
可选
include_archived
boolean
是否包含已归档的凭证空间，默认 false。
可选
请求结构
GET /api/dma/v1/vaults?limit=2 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/dma/v1/vaults?limit=2" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
凭证空间（Vault）列表。
可选
显示子属性
隐藏子属性
items
object {7}
显示子属性
隐藏子属性
type
string
资源类型标识，固定为 vault。
可选
id
string
凭证空间（Vault）标识，vault_ 前缀。
可选
display_name
string
显示名称。
可选
metadata
object
自定义键值。
可选
显示子属性
隐藏子属性
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
archived_at
string
归档时间，RFC 3339 格式，UTC；未归档时为 null。
可选
next_page
string
下一页游标；没有下一页时为 null。
可选
响应示例
{
"data": [
{
"type": "vault",
"id": "vault_23312a16793d4477",
"display_name": "doc-test-vault",
"metadata": {
"ticket": "doc"
},
"created_at": "2026-11-11T03:47:43Z",
"updated_at": "2026-11-11T03:47:43Z",
"archived_at": null
},
{
"type": "vault",
"id": "vault_b66ae85467e64630",
"display_name": "demo-vault",
"metadata": {},
"created_at": "2026-11-10T13:23:12Z",
"updated_at": "2026-11-10T13:23:12Z",
"archived_at": null
}
],
"next_page": "page_dmF1bHRfYjY2YWU4NTQ2N2U2NDYzMA"
}评价此篇文章