Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.analytics.synapside.com/llms.txt

Use this file to discover all available pages before exploring further.

O Motor CDP do S.Analytics oferece uma API de alto desempenho para o recebimento de dados, focada na ingestão em massa (Batch Insert). Isso garante que você possa sincronizar grandes volumes de registros de forma rápida e segura. Documentação da API >
O identificador da tabela (:table_name) deve ser o mesmo utilizado no momento da criação via API de Schema.

Como funciona

A ingestão ocorre dentro de uma transação única (rollback total). Isso significa que, ao enviar um lote de registros, ou todos são salvos com sucesso, ou nenhum é persistido. Se apenas um dos itens do seu lote contiver um erro (ex: tipo de dado incompatível), a transação inteira será cancelada.

Regras de Negócio

  1. Limite de Lote: Você pode enviar até 250 registros por chamada.
  2. Coluna de ID: O sistema gerará automaticamente um id (UUID v7) nativo para cada linha. Se você já possuir um ID externo e quiser persisti-lo, basta enviar o campo id no objeto JSON.
  3. Estrutura Unificada: Todos os objetos dentro do array do mesmo lote devem possuir as mesmas chaves (colunas).