获取凭证列表
本接口用于分页查询凭证空间(Vault)中的凭证(Credential)列表。
返回结果按游标分页:data 为当前页的凭证列表,next_page 为下一页游标;没有下一页时为 null。响应中不包含 token、密钥等敏感字段。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
凭证空间(Vault)标识。
凭证空间不存在时返回 404。
每页条数,默认 20,取值 1–100。
超出范围时返回 400。
翻页游标,取上一页响应的 next_page;第一页不传。
是否包含已归档的凭证,默认 false。
GET /api/dma/v1/vaults/{vault_id}/credentials HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
示例代码
curl --location --request GET "https://api.dumate.cn/api/dma/v1/vaults/vault_23312a16793d4477/credentials" \
--header 'Authorization: Bearer <YOUR_API_KEY>'
返回响应
凭证(Credential)列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
资源类型标识,固定为 vault_credential。
凭证(Credential)标识,cred_ 前缀。
所属凭证空间(Vault)标识。
显示名称;未设置时不返回该字段。
认证配置。
不返回 access_token、token、secret_value、refresh_token 等敏感字段。
显示子属性
隐藏子属性
认证类型。
可选值:mcp_oauth、static_bearer、environment_variable。
MCP 服务地址。
auth.type 为 mcp_oauth、static_bearer 时返回。
访问令牌的过期时间,RFC 3339 格式。
auth.type 为 mcp_oauth 且设置了该字段时返回。
环境变量名。
auth.type 为 environment_variable 时返回。
当前仅保存;运行时按环境变量注入,不区分 body、header。auth.type 为 environment_variable 时返回。
显示子属性
隐藏子属性
兼容字段,当前仅保存,不影响运行时注入。
兼容字段,当前仅保存,不影响运行时注入。
沙箱的网络策略。
auth.type 为 environment_variable 时返回。
显示子属性
隐藏子属性
网络策略类型。
自定义键值。
显示子属性
隐藏子属性
创建时间,RFC 3339 格式,UTC。
最近更新时间,RFC 3339 格式,UTC。
归档时间,RFC 3339 格式,UTC;未归档时为 null。
下一页游标;没有下一页时为 null。
{
"data": [
{
"type": "vault_credential",
"id": "cred_0dabd8629ed74ba5",
"vault_id": "vault_23312a16793d4477",
"display_name": "doc-test-env",
"auth": {
"type": "environment_variable",
"secret_name": "DOC_TEST_TOKEN",
"injection_location": {
"body": true,
"header": true
},
"networking": {
"type": "unrestricted"
}
},
"metadata": {},
"created_at": "2026-11-11T03:48:04Z",
"updated_at": "2026-11-11T03:48:04Z",
"archived_at": null
}
],
"next_page": null
}
评价此篇文章
