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

# Autenticação

> Autentique as requisições da API Pubrio usando o cabeçalho `pubrio-api-key` — configuração, gerenciamento de chaves e boas práticas de segurança.

## Chave de API

Para autenticação, é necessário incluir o cabeçalho `pubrio-api-key`. O cabeçalho deve conter a chave de API, por exemplo `a1b2c3d4e5f6g7h8`, que representa sua chave de API.

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

Você precisa criar uma chave de API para acessar a API Pubrio. Para criar uma chave de API, acesse a seção [Settings](https://dashboard.pubrio.com/#/settings/).

<Note>
  A chave de API já inclui as informações do seu workspace (perfil), portanto não é necessário enviar `profile_id` no corpo da requisição. O parâmetro `profile_id` ainda é aceito por compatibilidade com versões anteriores, mas não é mais obrigatório.
</Note>

## Cabeçalhos da requisição

Junto com `pubrio-api-key`, envie um cabeçalho `User-Agent` identificando seu cliente.

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

<Warning>
  **Um `User-Agent` ausente ou genérico é rejeitado antes de chegar à API.** Requisições sem um user agent reconhecido são bloqueadas na borda e retornam `HTTP 403` com o corpo em texto simples `error code: 1010` — não é JSON, e não é um dos [códigos de erro documentados](/pt/api-reference/status-codes). Isso parece uma falha de autenticação, mas não é: sua chave de API está correta.

  Os user agents padrão de bibliotecas HTTP comuns são afetados — o `urllib` do Python (`Python-urllib/3.x`) é bloqueado, enquanto `curl` e `requests` não são. Se você receber `error code: 1010`, defina um `User-Agent` explícito e tente novamente.
</Warning>