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.
Defina o acesso
Selecione o site e o menor conjunto de escopos necessário para a integração.
Salve o segredo
Use uma variável de ambiente do seu backend. O segredo não deve entrar no bundle do navegador.
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.
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.