Saltar al contenido principal

Resumen

Usa este endpoint para actualizar el nombre, el límite de uso, los modelos permitidos, la fecha de vencimiento o el estado de una API Key existente.

Cuerpo de la solicitud

La solicitud PATCH debe incluir al menos un campo.
CampoTipoValores por defecto / límitesDescripción
statusenum-active, inactive, revoked
namestringlongitud 1-50Nombre visible actualizado
limitAmountnumber | nullmínimo 0, máximo 100000null = ilimitado, 0 = cuota cero, valor positivo = tope en USD
limitCurrencyenumvalor por defecto USDOpcional: USD o CNY. Si se establece en CNY, limitAmount se interpreta en RMB y el servidor lo convierte a USD antes de guardarlo
modelsstring[]-Lista actualizada de modelos lógicos permitidos
expiresAtstring | nulldatetime RFC3339null elimina el vencimiento

Notas

  • La eliminación definitiva no está soportada intencionadamente en Management API v1.
  • revoked suele tratarse como un estado terminal; si necesitas volver a usar una clave, normalmente conviene crear una nueva.
  • De forma predeterminada, limitAmount se interpreta en USD. Si envías limitCurrency: "CNY", el límite se tratará como RMB y se convertirá automáticamente a USD con el tipo de cambio actual antes de guardarse.
  • La respuesta incluye exchange_rate y los campos de visualización en RMB limit_amount_cny y used_amount_cny.

Ejemplo

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
  }'

Solicitud / Respuesta

Consulta el panel interactivo de OpenAPI de arriba para ver el esquema exacto y los campos de la respuesta.