Skip to main content
POST
Validar CSV

Endpoint

Visão geral

Content-Type: multipart/form-data. Resposta: JSON com ok. HTTP 200 mesmo em falha — verificar ok. Para mapeamentos com target === user_event, a API também valida cada linha de dados após cabeçalhos OK (mapeamento, enums, identificadores obrigatórios) e reprova a pré-checagem com ok: false. Para mapeamentos com target === transaction, a API percorre as linhas de dados (até 50.000) e retorna warnings leves: a pré-checagem continua respondendo ok: true e a importação é permitida. Os targets de entidades validam só cabeçalhos.

Autenticação

Campos do formulário

Sucesso — só cabeçalhos (entity_*)

Sucesso com avisos — transações

Problemas de linha nunca bloqueiam a importação; são agrupados por problema, então cada entrada informa a primeira linha afetada e quantas linhas a compartilham.
Códigos de aviso: INVALID_ENUM_VALUE, AMOUNT_UNPARSEABLE, TYPE_OTHER, MISSING_REQUIRED_AFTER_MAP, DATE_UNPARSEABLE, DATE_KIND_AMBIGUOUS, MASKED_CARD_UNPARSEABLE, SCIENTIFIC_NOTATION.

Sucesso — eventos de usuário (todas as linhas válidas)

Falha de linhas — eventos de usuário

Quando uma ou mais linhas falham validação de mapeamento:
Use este preflight antes do import. Com batchErrorHandling: continue_collect_errors em Importar eventos, linhas inválidas são ignoradas e registradas no CSV de falhas do job; com rollback_all, o import retorna 400. Ver também: Importações em lote.