Gerenciamento

Listar chaves API

Lista as chaves API gerenciadas pelo usuário para o token de gerenciamento atual da organização.

GEThttps://api.tokenlab.sh/v1/management/api-keys

Visão Geral

Retorna as chaves API de usuário da organização associada ao token de gerenciamento atual.

Notas

  • Os campos monetários aceitam apenas USD.

  • As chaves gerenciadas pelo sistema são excluídas.

Exemplo

pageintegerquerypadrão: 1
Número da página a partir de 1.
limitintegerquerypadrão: 50
Tamanho da página de 1 a 100.

Requisição

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitação / Resposta

Esta página fornece o esquema OpenAPI e exemplos de requisições para copiar. Envie solicitações de gerenciamento pelo terminal ou cliente usando um Management Token; o envio direto não está disponível nesta página.

Exemplo de resposta

Resposta

200 OK
{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-live...",
      "status": "active",
      "limit_amount": 500,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": [
        "gpt-5.6-luna",
        "claude-3-7-sonnet"
      ],
      "expires_at": "2026-12-31T23:59:59.000Z",
      "last_used_at": "2026-07-08T03:12:45.000Z",
      "created_at": "2026-07-01T10:00:00.000Z",
      "delivery_policy": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Campos importantes

objectstring
Sempre list.
dataarray
Array de objetos de chave de API.
paginationobject
Metadados de paginação com page, limit, total e totalPages.
data[].idstring
Identificador da chave de API usado em chamadas subsequentes da API de Gerenciamento.
data[].namestring
Nome de exibição da chave de API.
data[].key_prefixstring
Prefixo de chave não secreto para exibição e suporte.
data[].statusstring
Um dos valores active, inactive, suspended ou revoked.
data[].limit_amountnumber | null
Limite de gastos em USD como número JSON para exibição. null significa ilimitado.
data[].limit_amount_decimalstring | null
Limite de gastos exato em USD como string decimal. null significa ilimitado.
data[].used_amountnumber
Gasto de uso acumulado em USD como número JSON para exibição.
data[].used_amount_decimalstring
Gasto de uso acumulado exato em USD como string decimal.
data[].modelsstring[]
Lista de modelos permitidos por chave. Um array vazio significa que não há restrição adicional de modelo no nível da chave.
data[].delivery_policystring | null
auto, verified, official, null. null herda a política de entrega do espaço de trabalho.
data[].expires_atstring | null
Carimbo de data/hora ISO em que a chave expira, ou null quando não há expiração.
data[].last_used_atstring | null
Carimbo de data/hora ISO do uso mais recente, ou null quando nunca foi usada.
data[].created_atstring
Carimbo de data/hora ISO de criação.

Autorização

ManagementTokenAuth
AuthorizationBearer <token>

Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.

Local: header

Resposta

application/json

application/json

application/json