{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/kmwbqxty8","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
GET
\n
\nhttps://api.dumate.cn/api/dma/v1/vaults?limit=2\n
\n
\n
\n

本接口用于分页查询凭证空间（Vault）列表。

\n

返回结果按游标分页：data 为当前页的凭证空间列表，next_page 为下一页游标；没有下一页时为 null。

\n
\n
\n

权限说明

\n

使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Query 参数
\n
\n
\n
\n
\n
\n\nlimit\n\ninteger\n
\n

每页条数，默认 20，取值 1–100。
超出范围时返回 400。

\n
\n
可选
\n
\n
\n
\n\npage\n\nstring\n
\n

翻页游标，取上一页响应的 next_page；第一页不传。

\n
\n
可选
\n
\n
\n
\n\ninclude_archived\n\nboolean\n
\n

是否包含已归档的凭证空间，默认 false。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
GET /api/dma/v1/vaults?limit=2 HTTP/1.1\nHost: api.dumate.cn\nAuthorization: Bearer <YOUR_API_KEY>
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
curl --location --request GET \"https://api.dumate.cn/api/dma/v1/vaults?limit=2\" \\\n  --header 'Authorization: Bearer <YOUR_API_KEY>'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\ndata\n\narray\n
\n

凭证空间（Vault）列表。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {7}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ntype\n\nstring\n
\n

资源类型标识，固定为 vault。

\n
\n
可选
\n
\n
\n
\n\nid\n\nstring\n
\n

凭证空间（Vault）标识，vault_ 前缀。

\n
\n
可选
\n
\n
\n
\n\ndisplay_name\n\nstring\n
\n

显示名称。

\n
\n
可选
\n
\n
\n
\n\nmetadata\n\nobject\n
\n

自定义键值。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n
\n\ncreated_at\n\nstring\n
\n

创建时间，RFC 3339 格式，UTC。

\n
\n
可选
\n
\n
\n
\n\nupdated_at\n\nstring\n
\n

最近更新时间，RFC 3339 格式，UTC。

\n
\n
可选
\n
\n
\n
\n\narchived_at\n\nstring\n
\n

归档时间，RFC 3339 格式，UTC；未归档时为 null。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\nnext_page\n\nstring\n
\n

下一页游标；没有下一页时为 null。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
{\n  \"data\": [\n    {\n      \"type\": \"vault\",\n      \"id\": \"vault_23312a16793d4477\",\n      \"display_name\": \"doc-test-vault\",\n      \"metadata\": {\n        \"ticket\": \"doc\"\n      },\n      \"created_at\": \"2026-11-11T03:47:43Z\",\n      \"updated_at\": \"2026-11-11T03:47:43Z\",\n      \"archived_at\": null\n    },\n    {\n      \"type\": \"vault\",\n      \"id\": \"vault_b66ae85467e64630\",\n      \"display_name\": \"demo-vault\",\n      \"metadata\": {},\n      \"created_at\": \"2026-11-10T13:23:12Z\",\n      \"updated_at\": \"2026-11-10T13:23:12Z\",\n      \"archived_at\": null\n    }\n  ],\n  \"next_page\": \"page_dmF1bHRfYjY2YWU4NTQ2N2U2NDYzMA\"\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
","fields":{"slug":"kmwbqxty8","title":"获取凭证空间列表","date":"2026-11-13","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"kmwbqxty8","prev":{"id":"9mwbqv2xw","name":"归档凭证空间","path":"9mwbqv2xw","filePath":"企业版使用指南/API参考/凭证管理/归档凭证空间.md","seo":null,"parentIds":["4mqamdvq3","hmw96earj","Xmw9aq9lw"],"parents":[{"id":"4mqamdvq3","documentId":"6ec3b03c-ae0d-4eba-b913-34b34d668224","name":"企业版使用指南","repoName":"Dumate","filePath":"企业版使用指南","disabled":false,"path":"4mqamdvq3","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"hmw96earj","documentId":"c50ada65-8724-4fc9-bd68-70a20864d00c","name":"API参考","repoName":"Dumate","filePath":"企业版使用指南/API参考","disabled":false,"path":"hmw96earj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Xmw9aq9lw","documentId":"b403973f-119f-44f1-8ffc-e44a41867411","name":"凭证管理","repoName":"Dumate","filePath":"企业版使用指南/API参考/凭证管理","disabled":false,"path":"Xmw9aq9lw","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Gmwbqz53r","name":"获取凭证空间详情","path":"Gmwbqz53r","filePath":"企业版使用指南/API参考/凭证管理/获取凭证空间详情.md","seo":null,"parentIds":["4mqamdvq3","hmw96earj","Xmw9aq9lw"],"parents":[{"id":"4mqamdvq3","documentId":"6ec3b03c-ae0d-4eba-b913-34b34d668224","name":"企业版使用指南","repoName":"Dumate","filePath":"企业版使用指南","disabled":false,"path":"4mqamdvq3","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"hmw96earj","documentId":"c50ada65-8724-4fc9-bd68-70a20864d00c","name":"API参考","repoName":"Dumate","filePath":"企业版使用指南/API参考","disabled":false,"path":"hmw96earj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Xmw9aq9lw","documentId":"b403973f-119f-44f1-8ffc-e44a41867411","name":"凭证管理","repoName":"Dumate","filePath":"企业版使用指南/API参考/凭证管理","disabled":false,"path":"Xmw9aq9lw","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"4mqamdvq3","documentId":"6ec3b03c-ae0d-4eba-b913-34b34d668224","name":"企业版使用指南","repoName":"Dumate","filePath":"企业版使用指南","disabled":false,"path":"4mqamdvq3","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"hmw96earj","documentId":"c50ada65-8724-4fc9-bd68-70a20864d00c","name":"API参考","repoName":"Dumate","filePath":"企业版使用指南/API参考","disabled":false,"path":"hmw96earj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Xmw9aq9lw","documentId":"b403973f-119f-44f1-8ffc-e44a41867411","name":"凭证管理","repoName":"Dumate","filePath":"企业版使用指南/API参考/凭证管理","disabled":false,"path":"Xmw9aq9lw","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}