# 模板 (/docs/api/native/vault/templates)



查询常用服务的模板 ID、Secret 名称、种类和允许域名。

[指南 →](/docs/cloud/services/vault/quickstart)

[基础地址与鉴权](/docs/api/native/vault)

| template_id | kind | 服务 |
| --- | --- | --- |
| github | static | GitHub (api.github.com, uploads.github.com) |
| openai | static | OpenAI |
| anthropic | static | Anthropic |
| stripe | static | Stripe |
| linear | oauth | Linear (CIMD) |
| atlassian | oauth | Atlassian (DCR) |

## 列出模板 [#列出模板]

`GET /vault/v1/templates`

### 响应 [#响应]

#### HTTP 200 [#http-200]

**application/json**

| 字段 | 类型 / 枚举 | 必填 | 说明 |
| --- | --- | --- | --- |
| data | VaultTemplate[] | 是 | 条目数组 |
| data[].id | string | 是 | 对象标识符 |
| data[].display_name | string | 是 | 显示名称，1–255 个字符 |
| data[].kind | "static" / "oauth" | 是 | static：你填写的值；oauth：授权得到、由平台续期 |
| data[].name | string | 是 | 名称，库内唯一且不可改；1–128 个大写字母、数字或下划线，以字母或下划线开头 |
| data[].allowed_hosts | string[] | 是 | 1–16 个域名、公网 IPv4 或 *.example.com；不匹配根域名。拒绝 IPv6、单标签主机、localhost、*.internal、平台域名及回环/链路本地/私网/CGNAT IPv4；规范化并去重 |
| data[].value_hint | string / null | 是 | 填写提示 |

### 错误响应 [#错误响应]

缺少或无效的 API Key 返回 401 UNAUTHENTICATED。
没有额外的领域错误。

```bash
curl "https://api.deepraxis.ai/vault/v1/templates" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
```

## VaultTemplate [#vaulttemplate]

| 字段 | 类型 / 枚举 | 必填 | 说明 |
| --- | --- | --- | --- |
| id | string | 是 | 对象标识符 |
| display_name | string | 是 | 显示名称，1–255 个字符 |
| kind | "static" / "oauth" | 是 | static：你填写的值；oauth：授权得到、由平台续期 |
| name | string | 是 | 名称，库内唯一且不可改；1–128 个大写字母、数字或下划线，以字母或下划线开头 |
| allowed_hosts | string[] | 是 | 1–16 个域名、公网 IPv4 或 *.example.com；不匹配根域名。拒绝 IPv6、单标签主机、localhost、*.internal、平台域名及回环/链路本地/私网/CGNAT IPv4；规范化并去重 |
| value_hint | string / null | 是 | 填写提示 |