Recupera os detalhes de um único vault, incluindo todas as credenciais, pelo ID do vault.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Token Bearer usado para autenticar a requisição. Formato: Bearer $QODER_PAT. |
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
vault_id |
string |
Sim |
Identificador exclusivo do vault a recuperar. |
Exemplo de requisição
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef" \
-H "Authorization: Bearer $QODER_PAT"Exemplo de resposta
HTTP 200 OK
{
"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"
}Campos da resposta
|
Campo |
Tipo |
Descrição |
|
id |
string |
Identificador exclusivo do vault, com prefixo vault_. |
|
type |
string |
Tipo do objeto. Sempre vault. |
|
display_name |
string |
Nome de exibição legível do vault. |
|
status |
string |
Estado atual do vault: active ou archived. |
|
metadata |
object |
Pares chave-valor personalizados associados ao vault. |
|
credentials |
array |
Credenciais vinculadas ao vault. O valor access_token nunca é retornado. |
|
created_at |
string |
Timestamp de criação no formato ISO 8601. |
|
updated_at |
string |
Timestamp da última atualização no formato ISO 8601. |
Erros
|
HTTP |
Tipo |
Gatilho |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
|
404 |
not_found_error |
Vault especificado não existe ou foi excluído. |
Para ver o envelope completo de erros, consulte Erros.