Validar CSV
Referência API
Validar CSV
Pré-checagem: validar cabeçalhos do CSV contra mapeamento salvo — pela API de importação em lote da gu1 para alto volume, com exemplos para validate csv.
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). Outros targets continuam validando só cabeçalhos.
Autenticação
Campos do formulário
Sucesso — só cabeçalhos (transaction, entity_*)
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: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.