Crie um novo vault. O vault armazena credenciais de acesso para servidores MCP com segurança e exige pelo menos uma credencial na criação.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Token Bearer para autenticar a requisição. Formato: Bearer $QODER_PAT. |
|
Content-Type |
Sim |
Deve ser application/json. |
Corpo da requisição
|
Campo |
Tipo |
Obrigatório |
Descrição |
|
display_name |
string |
Sim |
Nome de exibição legível do vault. |
|
credentials |
array |
Sim |
Credenciais para associar durante a criação. Deve conter pelo menos um objeto de credencial. |
Cada elemento do array credentials tem os seguintes campos:
|
Campo |
Tipo |
Obrigatório |
Descrição |
|
mcp_server_url |
string |
Sim |
URL do servidor MCP autorizado por esta credencial. |
|
protocol |
string |
Sim |
Protocolo de transporte. Use sse ou streamable_http. |
|
type |
string |
Sim |
Tipo de credencial. Atualmente, apenas static_bearer é compatível. |
|
access_token |
string |
Sim |
Token de acesso do servidor MCP. Obrigatório quando o tipo é static_bearer. |
Exemplo de requisição
curl -X POST "https://api.qoder.com.cn/api/v1/cloud/vaults" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"display_name": "my-mcp-vault",
"credentials": [
{
"mcp_server_url": "https://example.com/mcp",
"protocol": "sse",
"type": "static_bearer",
"access_token": "your-access-token"
}
]
}'Exemplo de resposta
HTTP 201 Created
{
"id": "vault_019e3bb940277f0db05ab74291acf6ef",
"type": "vault",
"display_name": "my-mcp-vault",
"status": "active",
"metadata": {},
"credentials": [
{
"id": "vcred_019e3bb940297658a632dbf920057eff",
"vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
"mcp_server_url": "https://example.com/mcp",
"protocol": "sse",
"type": "static_bearer",
"status": "active",
"created_at": "2026-05-18T15:34:16.876188Z",
"updated_at": "2026-05-18T15:34:16.876188Z"
}
],
"created_at": "2026-05-18T15:34:16.874877Z",
"updated_at": "2026-05-18T15:34:16.874877Z"
}Erros
|
HTTP |
Tipo |
Gatilho |
|
400 |
invalid_request_error |
Array credentials ausente: É necessária pelo menos uma credencial ao criar um vault. |
|
400 |
invalid_request_error |
access_token ausente: O campo 'access_token' é obrigatório para o tipo static_bearer. |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
Para ver o envelope completo de erros, consulte Erros.