获取凭证详情
更新时间:2026-11-13
GET
https://api.dumate.cn/api/dma/v1/vaults/{vault_id}/credentials/{credential_id}
本接口用于查询单个凭证(Credential)的详情。
响应中不包含 token、密钥等敏感字段。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
vault_id
string
凭证空间(Vault)标识。
凭证空间不存在时返回 404。
必选
credential_id
string
凭证(Credential)标识。
凭证不存在时返回 404。
必选
请求结构
GET /api/dma/v1/vaults/{vault_id}/credentials/{credential_id} 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/cred_0dabd8629ed74ba5" \
--header 'Authorization: Bearer <YOUR_API_KEY>'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
type
string
资源类型标识,固定为 vault_credential。
可选
id
string
凭证(Credential)标识,cred_ 前缀。
可选
vault_id
string
所属凭证空间(Vault)标识。
可选
display_name
string
显示名称;未设置时不返回该字段。
可选
auth
object {6}
认证配置。
不返回 access_token、token、secret_value、refresh_token 等敏感字段。
可选
显示子属性
隐藏子属性
type
string
认证类型。
可选值:mcp_oauth、static_bearer、environment_variable。
可选
mcp_server_url
string
MCP 服务地址。
auth.type 为 mcp_oauth、static_bearer 时返回。
可选
expires_at
string
访问令牌的过期时间,RFC 3339 格式。
auth.type 为 mcp_oauth 且设置了该字段时返回。
可选
secret_name
string
环境变量名。
auth.type 为 environment_variable 时返回。
可选
injection_location
object {2}
当前仅保存;运行时按环境变量注入,不区分 body、header。auth.type 为 environment_variable 时返回。
可选
显示子属性
隐藏子属性
body
boolean
兼容字段,当前仅保存,不影响运行时注入。
可选
header
boolean
兼容字段,当前仅保存,不影响运行时注入。
可选
networking
object {1}
沙箱的网络策略。
auth.type 为 environment_variable 时返回。
可选
显示子属性
隐藏子属性
type
string
网络策略类型。
可选
metadata
object
自定义键值。
可选
显示子属性
隐藏子属性
created_at
string
创建时间,RFC 3339 格式,UTC。
可选
updated_at
string
最近更新时间,RFC 3339 格式,UTC。
可选
archived_at
string
归档时间,RFC 3339 格式,UTC;未归档时为 null。
可选
响应示例
{
"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
}
评价此篇文章
