Skip to main content
Disponible en: el plan EnterpriseDónde encontrarlo: Settings en el menú del nombre de la organización, en la parte superior izquierda de la pantalla > Account > API Keys

​
Descripción general

Para autenticar tus solicitudes a la API, necesitas una clave de API. Esta clave identifica y autoriza tus solicitudes, lo que garantiza que solo los usuarios autorizados puedan acceder a los recursos. Tu clave de API proporciona acceso a todos los datos disponibles para tu organización, incluidas las categorías, las regiones y los informes de categorías.

​
Cómo obtener tu clave de API

1

Ve al portal de generación de claves de API

  1. Inicia sesión en la plataforma. Selecciona el nombre de tu organización en la parte superior izquierda de la pantalla y luego selecciona Settings.
  2. En la barra lateral izquierda, en Account, selecciona API Keys. Se mostrará tu portal de generación de claves y una tabla con tus claves.
2

Configura y crea tu clave

  1. En el banner Create API Key, introduce un nombre de clave y selecciona el período de Expiration.
  2. Selecciona Create API Key para generar la clave.
Por seguridad, no podrás volver a recuperar tu clave. Copia y guarda tu clave de API de forma segura antes de continuar.
Tus claves de API se muestran en una tabla en la página API Keys. Vuelve a esta página en cualquier momento para ver tus claves, comprobar sus fechas de vencimiento o revocar una clave existente.

​
Métodos de autenticación

Puedes autenticar tus solicitudes con cualquiera de los métodos siguientes:

​
Autenticación por encabezado (recomendada)

Incluye tu clave de API en el encabezado X-API-Key:

​
Alcance y permisos de la clave de API

Tu clave de API proporciona acceso a:
  • Datos de la organización: todos los datos que pertenecen a tu organización
  • Categorías: las categorías de datos disponibles y sus metadatos
  • Datos regionales: información y filtros basados en la ubicación
  • Informes: informes y análisis generados para tus categorías
  • Datos sin procesar: datos sin procesar dentro de las categorías a las que tienes acceso

​
Prácticas recomendadas de seguridad

  • Mantén las claves en privado: tu clave de API es información confidencial. Nunca la compartas públicamente ni la confirmes en el control de versiones. Guárdala de forma segura y trátala como una contraseña.
  • Usa variables de entorno: guarda las claves en variables de entorno o en archivos de configuración seguros.
  • Rótalas con regularidad: considera rotar tus claves de API periódicamente para mejorar la seguridad.
  • Supervisa el uso: revisa el uso de tu API con regularidad para detectar cualquier acceso no autorizado.

​
Errores de autenticación

Errores de autenticación comunes y su significado:

​
¿Necesitas ayuda?

Si tienes problemas de autenticación, contacta al equipo de soporte para obtener ayuda.