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

# Autenticación

> Autentica las solicitudes a la API de Pubrio mediante el encabezado `pubrio-api-key` — configuración, gestión de claves y prácticas recomendadas de seguridad.

## Clave de API

Para autenticarte, es necesario incluir el encabezado `pubrio-api-key`. Este encabezado debe contener la clave de API, por ejemplo `a1b2c3d4e5f6g7h8`, que representa tu clave de API.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
```

Necesitas crear una clave de API para acceder a la API de Pubrio. Para crear una clave de API, puedes hacerlo desde la sección de [Configuración](https://dashboard.pubrio.com/#/settings/).

<Note>
  La clave de API ya incluye la información de tu espacio de trabajo (perfil), por lo que no es necesario enviar `profile_id` en el cuerpo de la solicitud. El parámetro `profile_id` sigue siendo aceptado por compatibilidad con versiones anteriores, pero ya no es obligatorio.
</Note>

## Encabezados de la solicitud

Además de `pubrio-api-key`, envía un encabezado `User-Agent` que identifique tu cliente.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
Content-Type: application/json
User-Agent: my-app/1.0
```

<Warning>
  **Un `User-Agent` ausente o demasiado genérico se rechaza antes de que la solicitud llegue a la API.** Las solicitudes sin un user agent reconocible se bloquean en el perímetro de la red y devuelven `HTTP 403` con el cuerpo en texto plano `error code: 1010` — no es JSON, ni tampoco uno de los [códigos de error documentados](/es/api-reference/status-codes). Esto parece un fallo de autenticación, pero no lo es: tu clave de API está bien.

  Los user agents predeterminados de las bibliotecas HTTP más comunes se ven afectados — el de `urllib` de Python (`Python-urllib/3.x`) queda bloqueado, mientras que `curl` y `requests` no. Si obtienes `error code: 1010`, define un `User-Agent` explícito y vuelve a intentarlo.
</Warning>