API de Ingestão

Para ingestão programática de dados, use a API REST para enviar métricas e dados diretamente para a plataforma.

Endpoint

POST /v1/ingest/metrics

Autenticação

Inclua sua chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Corpo da Requisição

{
  "table": "my_metrics",
  "rows": [
    {
      "date": "2025-01-15",
      "metric_name": "revenue",
      "value": 15234.50,
      "region": "south"
    }
  ]
}

Exemplo com cURL

curl -X POST https://lake.iaradata.com/api/v1/ingest/metrics \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-id-12345" \
  -d '{
    "table": "my_metrics",
    "rows": [
      {"date": "2025-01-15", "metric_name": "revenue", "value": 15234.50}
    ]
  }'

Resposta

{
  "status": "ok",
  "table": "my_metrics",
  "rowsIngested": 1
}

PII e Privacidade

A API de ingestão detecta e mascara automaticamente dados de PII:

Tipo de PII	Detecção	Mascaramento
Endereços de e-mail	Correspondência de padrão	j***@example.com
Números de cartão de crédito	Algoritmo de Luhn	****-****-****-1234
CPF/CNPJ	Padrões de documentos brasileiros	***.***.***-12
Números de telefone	Detecção de formato internacional	(**) *****-1234

atenção

Idempotência: Sempre inclua um cabeçalho Idempotency-Key nas requisições POST. Se a mesma chave for enviada duas vezes, a segunda requisição retorna o resultado em cache em vez de duplicar os dados.

Limites de Taxa

Os limites de taxa da API dependem do seu plano:

Plano	Requisições/minuto
Free	30
Starter	60
Growth	120
Business	300

Os cabeçalhos de limite de taxa são incluídos em toda resposta:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1706812800