# Autenticação e escopos

Crie uma chave privada com acesso apenas às operações e sites necessários.

## Criar e guardar uma chave

Na dashboard, abra Chaves privadas da API. Escolha escopos e sites; copie o segredo exibido na criação e guarde-o no servidor.

1. **Defina o acesso**: Selecione o site e o menor conjunto de escopos necessário para a integração.
2. **Salve o segredo**: Use uma variável de ambiente do seu backend. O segredo não deve entrar no bundle do navegador.
3. **Envie o header**: Use Authorization: Bearer seguido da chave privada nas chamadas de API.


## Header de autorização

O prefixo de uma chave privada é pulsant_sk_. O exemplo usa uma variável de ambiente; não há segredo incorporado.


```bash
curl "https://api.pulsant.app/v1/account/sites/$PULSANT_SITE_ID/analytics?days=7" \
  -H "Authorization: Bearer $PULSANT_SECRET_KEY"
```



## Qual escopo usar

Uma chave não ganha acesso a sites fora da sua autorização. Revogação e permissões atuais são revalidadas no servidor.


| Escopo | Uso |
| --- | --- |
| analytics:read | Consultar métricas e análises autorizadas |
| analytics:write | Enviar eventos pelo servidor |
| integrations:write | Registrar pagamentos e ajustes autorizados |



## Chave privada e site ID

O site ID aparece no script público de instalação. Ele não substitui uma chave privada. A autenticação da dashboard usa sessão e não é o mecanismo recomendado para integrações server-side.


- [Instalar o script público](/installation)
- [Tratar respostas 401 e 403](/api/errors)