> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Crea una clave de API de Profound y úsala para autenticar tus solicitudes a la REST API

<Info>
  **Disponible en**: el plan Enterprise

  **Dónde encontrarlo**: Settings en el menú del nombre de la organización, en la parte superior izquierda de la pantalla > Account > API Keys
</Info>

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    <Note>
      Por seguridad, no podrás volver a recuperar tu clave. Copia y guarda tu clave de API de forma segura antes de continuar.
    </Note>

    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.
  </Step>
</Steps>

## 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`:

<CodeGroup>
  ```http Header Method theme={null}
  POST /v1/reports/visibility HTTP/1.1
  Host: api.tryprofound.com
  X-API-Key: your_api_key_here
  Content-Type: application/json
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.tryprofound.com/v1/reports/visibility" \
    -H "X-API-Key: your_api_key_here" \
    -H "Content-Type: application/json"
  ```
</CodeGroup>

## 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:

| Código de estado | Error | Descripción |
| - | - | - |
| `401 Unauthorized` | Clave de API no válida | La clave de API proporcionada es incorrecta o ha vencido |
| `403 Forbidden` | Permisos insuficientes | Tu clave de API no tiene acceso al recurso solicitado |
| `429 Too Many Requests` | Límite de solicitudes superado | Superaste el límite de solicitudes de tu clave de API |

## ¿Necesitas ayuda?

Si tienes problemas de autenticación, [contacta al equipo de soporte](mailto:support@tryprofound.com) para obtener ayuda.