校验 MCP OAuth 凭证
更新时间：2026-11-13
POST
https://api.dumate.cn/api/dma/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate
本接口用于校验 mcp_oauth 类型的凭证（Credential）是否可用，系统会用该凭证实际请求一次 MCP 服务。
仅支持 auth.type 为 mcp_oauth 的凭证，其他类型返回 400。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
vault_id
string
凭证空间（Vault）标识。
凭证空间不存在时返回 404。
必选
credential_id
string
凭证（Credential）标识。
凭证不存在时返回 404；凭证的 auth.type 不是 mcp_oauth 时返回 400。
必选
请求结构
POST /api/dma/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/vaults/vault_23312a16793d4477/credentials/cred_0dabd8629ed74ba5/mcp_oauth_validate" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 vault_credential_validation。
可选
status
string
校验结果。
可选值：valid（可用）、invalid（被 MCP 服务拒绝）、unknown（无法判断，例如服务不可达）。
可选
vault_id
string
凭证空间标识。
可选
credential_id
string
凭证标识。
可选
has_refresh_token
boolean
是否包含刷新令牌。
可选
mcp_probe
objectnull
MCP 服务探测结果。探测失败时包含 method 与 http_response；成功时为 null。
可选
refresh
null
当前固定为 null。
可选
validated_at
string
校验时间，RFC 3339 格式。
可选
响应示例
{
"type": "vault_credential_validation",
"status": "valid"
}评价此篇文章