Enviar eventos

Existem quatro formas de enviar eventos para a Aira. A escolha depende do seu caso de uso: integração em tempo real, importação de dados históricos ou testes manuais.

​

Métodos de envio

curl -X POST https://api.useaira.com/v1/events/ingest \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sua_chave_api" \
  -d '{
    "events": [
      {
        "idempotencyKey": "evt-2024-01-15-acme-001",
        "customerExternalId": "acme_001",
        "eventName": "api_request",
        "occurredAt": "2024-01-15T14:30:00Z",
        "properties": {
          "value": 1,
          "endpoint": "/v1/payments",
          "method": "POST"
        }
      }
    ]
  }'

​

Transação atômica

​

Boas práticas

• Use nomes de evento consistentes: Padronize os nomes de evento (ex: api_request, storage_used) e documente-os. Recursos dependem do eventName para filtrar, e nomes inconsistentes causam dados perdidos.
• Inclua propriedades úteis para segmentação: Além do value, envie propriedades como endpoint, region, plan_tier. Isso permite criar recursos com filtros granulares sem alterar a integração depois.
• Capture no nível mais granular possível: Envie eventos individuais em vez de totais pré-agregados. Deixe os recursos da Aira fazerem a agregação. Isso dá flexibilidade para mudar modelos de precificação no futuro sem alterar a integração.

​

Próximos passos

• Propriedades e idempotência — entenda como prevenir duplicatas e usar propriedades para segmentação
• Recursos — configure como os eventos serão agregados em métricas de cobrança