Skip to main content

Resumen

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

Cuerpo de la solicitud

Debe enviarse al menos un campo.

Notas

  • Los campos monetarios solo admiten USD. Las entradas CNY están retiradas y devuelven 400 currency_retired.
  • La eliminación dura no está soportada a propósito en Management API v1.
  • revoked es un estado terminal para el uso operativo normal; crea una nueva clave en lugar de esperar un futuro flujo de reactivación.

Ejemplo

Solicitud / Respuesta

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

Ejemplo de respuesta

Campos importantes

string
Identificador de clave API usado en llamadas posteriores a la API de gestión.
string
Nombre para mostrar de la clave API.
string
Prefijo de clave no secreto para visualización y soporte.
string
Uno de los valores active, inactive o revoked.
number | null
Límite de gasto en USD como número JSON para visualización. null significa sin límite.
string | null
Límite de gasto exacto en USD como cadena decimal. null significa sin límite.
number
Gasto de uso acumulado en USD como número JSON para visualización.
string
Gasto de uso acumulado exacto en USD como cadena decimal.
string[]
Lista de modelos permitidos por clave. Un array vacío significa que no hay una restricción adicional de modelos a nivel de clave.
string | null
Marca de tiempo ISO en la que vence la clave, o null si no caduca.
string | null
Marca de tiempo ISO del uso más reciente, o null si nunca se ha usado.
string
Marca de tiempo ISO de creación.