文档中心/ 百度搭子/ 企业版使用指南/ API参考/ 凭证管理/ 创建凭证空间

创建凭证空间

POST
https://api.dumate.cn/api/v1/vaults

本接口用于创建凭证空间(Vault)。凭证空间用于隔离凭证(Credential),创建成功后返回凭证空间标识 id。

权限说明

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

请求参数

Headers 参数
除公共头域外,无其它特殊头域
Body 参数
name string

凭证空间(Vault)名称。
不能为空。

必选
请求结构
POST /api/v1/vaults HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "name": "示例业务凭证库"
}

示例代码

请求示例
curl --location --request POST "https://api.dumate.cn/api/v1/vaults" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data '{
    "name": "示例业务凭证库"
}'

返回响应

Headers 参数
除公共头域外,无其它特殊头域
返回参数
id string

凭证空间(Vault)标识。

可选
name string

凭证空间(Vault)名称。

可选
status string

凭证空间(Vault)状态。
可选值:
active:有效。
revoked:已删除。

可选
createdAt string

创建时间,ISO 8601 格式,UTC 时间。

可选
updatedAt string

最近更新时间,ISO 8601 格式,UTC 时间。

可选
响应示例
{
    "id": "vault_4564398e316444ee",
    "name": "示例业务凭证库",
    "status": "active",
    "createdAt": "2026-09-03T11:37:19Z",
    "updatedAt": "2026-09-03T11:37:19Z"
}