搜索 Vaults - Qoder CN

POST /api/v1/cloud/vaults/search 必须携带 x-qoder-beta: search-2026-08-31。所有参数均可选并放在 JSON Body 中；URL Query 参数会被忽略。

参数	类型	说明
`metadata`	object<string,string>	metadata 精确匹配条件，多个条件为 AND
`limit`	integer	分页大小
`page`	string	`next_page` 返回的游标
`include_archived`	boolean	是否包含已归档 Vault
`name`	string	显示名称模糊匹配（包含关系），不区分大小写

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/vaults/search" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" -H "Content-Type: application/json" \
  -H "x-qoder-beta: search-2026-08-31" \
  -d '{"metadata":{"team":"core"},"limit":20}'

响应

字段	类型	说明
`data`	array	当前页资源列表，资源字段见对应 List 接口
`first_id`	string \| null	当前页第一条资源 ID
`last_id`	string \| null	当前页最后一条资源 ID
`has_more`	boolean	是否还有下一页
`next_page`	string \| null	下一页游标，无下一页时为 `null`
`total`	integer \| null	首页返回满足筛选条件的资源总条数；使用 `page` 翻页时返回 `null`

{
  "data": [],
  "first_id": null,
  "has_more": false,
  "last_id": null,
  "next_page": null,
  "total": 0
}

data 中的资源字段与列出 Vaults一致。metadata key 长度为 1～64 个字符，value 必须是最长 512 个字符的字符串。默认在途并发上限为 10，超限返回 429 rate_limit_error。

​响应

响应