# API da Pulsant

Uma referência para integrar eventos, consultar métricas e registrar receita pelo servidor.

## Escolha seu caminho

As chamadas privadas usam uma chave da conta e um site autorizado. O site ID público identifica o site; a chave privada autoriza a operação.


- [Autenticação e escopos](/api/authentication)
- [Enviar eventos](/api/events)
- [Consultar analytics](/api/analytics)
- [Registrar receita](/api/revenue)

## Sua primeira consulta

Defina PULSANT_SITE_ID e PULSANT_SECRET_KEY no servidor. O exemplo consulta os últimos sete dias.


### cURL



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


### Node.js / fetch



```ts
const response = await fetch(
  `https://api.pulsant.app/v1/account/sites/${process.env.PULSANT_SITE_ID}/analytics?days=7`,
  { headers: { Authorization: `Bearer ${process.env.PULSANT_SECRET_KEY}` } }
);
if (!response.ok) throw new Error(`Falha na consulta: ${response.status}`);
const report = await response.json();
```



## Rotas principais

A conta é derivada da credencial. Não é necessário enviar um ID de conta na URL.


| Método | Rota | Escopo |
| --- | --- | --- |
| GET | /v1/account/sites/:siteId/analytics | analytics:read |
| GET | /v1/account/sites/:siteId/analytics/breakdown | analytics:read |
| POST | /v1/account/sites/:siteId/events | analytics:write |
| POST | /v1/account/sites/:siteId/payments | integrations:write |



## Contrato completo

O OpenAPI do ambiente em execução descreve os endpoints e os schemas publicados. Use-o para conferir campos e respostas do seu ambiente.


- [Abrir OpenAPI](https://api.pulsant.app/openapi)
- [Baixar openapi.json](https://api.pulsant.app/openapi.json)
- [Erros e retries](/api/errors)