Claves API

Las claves API autentican sus solicitudes a la API. Las gestiona completamente desde el panel de control: establezca una categoría, restrinja el uso con cuotas deslizantes, añada una fecha de expiración y monitorice la actividad por clave a través de los registros de solicitudes.

Para saber cómo incluir una clave en una solicitud, consulte la Introducción.

Crear una clave

Campos de la clave

Categorías

Las categorías etiquetan las claves para su organización. Aparecen en los filtros y análisis del panel de control pero no cambian cómo la API procesa una solicitud.

Mantenga una clave por entorno para poder revocarla o rotarla de forma independiente.

Cuotas por clave

Cada clave puede tener límites máximos independientes sobre el volumen de solicitudes, aplicados en ventanas deslizantes (no límites de calendario):

Deje un campo en blanco para no aplicar límite para esa ventana. Cuando se alcanza una cuota, la API devuelve 401 Rate Limit Exceeded con el nombre de la cuota en el mensaje:

{ "error": "Rate limit exceeded: quota total" }

{ "error": "Rate limit exceeded: quota daily" }

{ "error": "Rate limit exceeded: quota weekly" }

{ "error": "Rate limit exceeded: quota monthly" }

Las cuotas por clave son distintas de los límites de tasa a nivel de plan (límites por segundo y por minuto que se aplican a toda la cuenta). Los límites de plan devuelven 429 Too Many Requests. Consulte Gestión de errores para más detalles.

Expiración

Establezca una fecha de expiración en claves usadas en scripts, pipelines de CI o integraciones con socios. Una vez superada la fecha, la API devuelve:

{ "error": "Expired API Key" }

Código de estado HTTP 401. Cree y despliegue una clave de reemplazo antes de la fecha de expiración para evitar interrupciones.

Registros de solicitudes

Cada solicitud realizada con una clave queda registrada en Claves API → Registros en el panel de control. Cada entrada muestra:

Use los registros para auditar la actividad por clave, depurar errores inesperados o identificar tráfico de claves comprometidas.

Desactivar vs. eliminar

Prefiera la desactivación a la eliminación. Si una clave tiene historial de solicitudes, no puede eliminarse. El historial se conserva para facturación y auditoría.

Rotación de una clave

Referencia de errores

Véase también: Buenas prácticas para directrices de seguridad y Glosario para definiciones de términos.