API de Ingesta

Para la ingesta programática de datos, usa la API REST para enviar métricas y datos directamente a la plataforma.

Endpoint

POST /v1/ingest/metrics

Autenticación

Incluye tu clave de API en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Cuerpo de la Solicitud

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

Ejemplo con 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}
    ]
  }'

Respuesta

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

PII y Privacidad

La API de ingesta detecta y enmascara automáticamente los datos de PII:

Tipo de PII	Detección	Enmascaramiento
Direcciones de correo electrónico	Coincidencia de patrones	j***@example.com
Números de tarjeta de crédito	Algoritmo de Luhn	****-****-****-1234
CPF/CNPJ	Patrones de documentos brasileños	***.***.***-12
Números de teléfono	Detección de formato internacional	(**) *****-1234

aviso

Idempotencia: Siempre incluye un encabezado Idempotency-Key en las solicitudes POST. Si la misma clave se envía dos veces, la segunda solicitud devuelve el resultado en caché en lugar de duplicar los datos.

Límites de Tasa

Los límites de tasa de la API dependen de tu plan:

Plan	Solicitudes/minuto
Free	30
Starter	60
Growth	120
Business	300

Los encabezados de límite de tasa se incluyen en cada respuesta:

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