Lista todos os vaults da conta atual. Suporta paginação e filtragem por status.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Token Bearer para autenticar a requisição. Formato: Bearer $QODER_PAT. |
Parâmetros de consulta
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
limit |
integer |
Não |
Número máximo de vaults retornados por página. |
|
after |
string |
Não |
Cursor de paginação. Retorna registros posteriores a este ID de vault. |
|
status |
string |
Não |
Filtra resultados pelo status do vault. Valores aceitos: active ou archived. |
Para ver a especificação completa de paginação, consulte Paginação.
Exemplo de requisição
# List all vaults
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults" \
-H "Authorization: Bearer $QODER_PAT"
# Paginated request
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults?limit=2" \
-H "Authorization: Bearer $QODER_PAT"
# Filter by status
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/vaults?status=archived" \
-H "Authorization: Bearer $QODER_PAT"Exemplo de resposta
HTTP 200 OK
{
"data": [
{
"id": "vault_019e3bb940277f0db05ab74291acf6ef",
"type": "vault",
"display_name": "my-mcp-vault",
"status": "active",
"metadata": {},
"created_at": "2026-05-18T15:34:16.874877Z",
"updated_at": "2026-05-18T15:34:16.874877Z"
}
],
"first_id": "vault_019e3bb940277f0db05ab74291acf6ef",
"last_id": "vault_019e3bb940277f0db05ab74291acf6ef",
"has_more": false
}Resultado vazio:
{
"data": [],
"first_id": null,
"last_id": null,
"has_more": false
}Campos da resposta
|
Campo |
Tipo |
Descrição |
|
|
data |
array |
Array de objetos vault na página atual. |
|
|
first_id |
string \ |
null |
ID do primeiro vault da página ou null se a página estiver vazia. |
|
last_id |
string \ |
null |
ID do último vault da página. Use este valor como after para obter a próxima página. Retorna null se a página estiver vazia. |
|
has_more |
boolean |
true se houver mais vaults disponíveis; caso contrário, false. |
Erros
|
HTTP |
Tipo |
Causa |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
Para ver o envelope completo de erros, consulte Erros.