Saltar para o conteúdo principal

​
Visão geral

Use este endpoint para atualizar nome, limite de uso, modelos permitidos, data de expiração ou status de uma API Key existente.

​
Corpo da requisição

A requisição PATCH deve incluir pelo menos um campo.
CampoTipoPadrões / limitesDescrição
statusenum-active, inactive, revoked
namestringtamanho 1-50Nome de exibição atualizado
limitAmountnumber | nullmínimo 0, máximo 100000null = ilimitado, 0 = quota zero, valor positivo = teto em USD
limitCurrencyenumpadrão USDOpcional: USD ou CNY. Quando definido como CNY, limitAmount é interpretado em RMB e convertido para USD no servidor antes de ser armazenado
modelsstring[]-Allowlist atualizada de modelos lógicos
expiresAtstring | nulldatetime RFC3339null remove a expiração

​
Observações

  • A exclusão definitiva não é suportada intencionalmente na Management API v1.
  • revoked costuma ser tratado como estado terminal; se você precisar usar outra chave, normalmente é melhor criar uma nova.
  • Por padrão, limitAmount é interpretado em USD. Se você enviar limitCurrency: "CNY", o limite será tratado como RMB e convertido automaticamente para USD com a taxa atual antes de ser armazenado.
  • A resposta inclui exchange_rate e os campos de exibição em RMB limit_amount_cny e used_amount_cny.

​
Exemplo

curl -X PATCH "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

​
Requisição / Resposta

Consulte o painel interativo de OpenAPI acima para ver o schema exato e os campos da resposta.