Limpeza de CSV e Mapeamento de Colunas API API ID: 12804

Analisa valida mapeia visualiza e limpa texto CSV para preparação de importação
Use esta API do seu agente de IA via MCP
Funciona com OpenClaw, Claude Code/Desktop, Cursor, Windsurf, Cline e qualquer cliente de IA compatível com MCP.
Docs e configuração
Crie uma skill envolvendo este MCP: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

A API de Limpeza de CSV e Mapeamento de Colunas analisa, valida, mapeia, visualiza e limpa dados CSV para preparação de importação

A API lida com estrutura CSV, contagem de linhas, contagem de colunas, cabeçalhos detectados, cabeçalhos duplicados, cabeçalhos em branco, campos esperados ausentes, detecção de tipo de coluna, valores semelhantes a e-mails, valores semelhantes a inteiros, valores semelhantes a flutuantes, valores semelhantes a booleanos, valores vazios, validação de campos obrigatórios, erros de validação em nível de linha, sugestões de mapeamento de colunas, mapeamento de campos de origem para destino, saída CSV limpa, linhas de visualização, avisos, status de validação, status de uso, notas de segurança e isenção de responsabilidade

A API retorna resultados da análise CSV, contagem de linhas, contagem de colunas, colunas detectadas, cabeçalhos duplicados, cabeçalhos em branco, palpites de tipo de coluna, campos esperados ausentes, status de validação, erros em nível de linha, avisos, saída de mapeamento de colunas, texto CSV limpo, linhas de visualização, saída de preparação de importação normalizada e isenção de responsabilidade técnica

Esta API é útil para construtores de SaaS, plataformas de CRM, equipes de operações de dados, equipes de operações de marketing, equipes de operações de vendas, agências, desenvolvedores, equipes de backend, equipes de frontend, equipes de QA, plataformas de ecommerce, serviços de importação de leads, serviços de importação de clientes, serviços de importação de CSV, plataformas sem código, equipes de ferramentas internas, equipes de software B2B, equipes de análise, plataformas de automação, equipes de integração de dados, equipes de RevOps, equipes de operações comerciais, equipes que usam muito planilhas, plataformas de desenvolvedores, serviços ETL leves e serviços de automação de fluxo de trabalho

A API processa texto CSV enviado em solicitações de API e retorna análise técnica, validação, mapeamento, visualização e resultados de limpeza. Ela não hackeia, não faz força bruta, não tenta logins, não escaneia sistemas privados, não coleta conteúdo restrito, não altera dados do cliente, não envia e-mails, não cria eventos de calendário, não importa dados em sistemas de terceiros, não aprova ou rejeita dados, não verifica precisão fiscal, não verifica precisão contábil, não verifica precisão legal ou não verifica precisão de conformidade. Ela não substitui a revisão humana de dados limpos, uma plataforma ETL completa, um armazém de dados ou uma revisão profissional de engenharia de dados

Documentação da API

Endpoints


Analisa texto CSV e retorna contagem de linhas, contagem de colunas, colunas detectadas, cabeçalhos duplicados, cabeçalhos em branco, palpites de tipo de coluna, campos esperados ausentes, avisos e aviso legal



                                                                            
POST https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25192/analyze+csv
                                                                            
                                                                        

Analisar CSV - Recursos do endpoint

Objeto Descrição
Corpo da requisição [Obrigatório] Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA


RESPOSTA DE EXEMPLO DA API

{"ok":true,"rowCount":2,"columnCount":3,"originalHeaders":["name","email","age"],"normalizedHeaders":["name","email","age"],"duplicateHeaders":[],"blankHeaders":[],"inferredDataTypes":{"name":"string","email":"email-like","age":"integer"},"missingExpectedFields":[],"recommendations":["CSV structure looks ready for basic import checks."],"warnings":[],"disclaimer":"This API analyzes and transforms CSV text for import preparation. Review cleaned data before using it in production systems."}

Analisar CSV - TRECHOS DE CÓDIGO


curl --location --request POST 'https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25192/analyze+csv' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
	"csvText": "name,email,age\nAlice,[email protected],31\nBob,[email protected],42"
}'

    

Mapeia os nomes das colunas CSV de origem para os campos de destino solicitados e retorna sugestões de mapeamento de colunas e a saída de mapeamento de campo de origem para destino



                                                                            
POST https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25193/map+columns
                                                                            
                                                                        

Mapear Colunas - Recursos do endpoint

Objeto Descrição
Corpo da requisição [Obrigatório] Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA


RESPOSTA DE EXEMPLO DA API

{"ok":true,"suggestedMapping":[{"targetField":"first_name","sourceColumn":"First Name","normalizedSourceColumn":"first_name","score":1.0},{"targetField":"email","sourceColumn":"Email Address","normalizedSourceColumn":"email_address","score":0.75},{"targetField":"phone_number","sourceColumn":"Phone","normalizedSourceColumn":"phone","score":0.75}],"unmappedSourceColumns":[],"missingTargetFields":[],"warnings":[],"disclaimer":"This API analyzes and transforms CSV text for import preparation. Review cleaned data before using it in production systems."}

Mapear Colunas - TRECHOS DE CÓDIGO


curl --location --request POST 'https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25193/map+columns' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
	"csvText": "First Name,Email Address,Phone\nAlice,[email protected],555-1111",
	"targetFields": [
		"first_name",
		"email",
		"phone_number"
	]
}'

    

Valida linhas CSV usando regras como campos obrigatórios e retorna a saída de validação em nível de linha, contagens de linhas válidas, contagens de linhas inválidas, erros e avisos



                                                                            
POST https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25194/validate+rows
                                                                            
                                                                        

Validar Linhas - Recursos do endpoint

Objeto Descrição
Corpo da requisição [Obrigatório] Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA


RESPOSTA DE EXEMPLO DA API

{"ok":true,"validRowsCount":1,"invalidRowsCount":1,"rowErrors":[{"rowNumber":3,"column":"email","rule":"required","valuePreview":""}],"warnings":["Some rows failed validation."],"disclaimer":"This API analyzes and transforms CSV text for import preparation. Review cleaned data before using it in production systems."}

Validar Linhas - TRECHOS DE CÓDIGO


curl --location --request POST 'https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25194/validate+rows' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
	"csvText": "name,email,age\nAlice,[email protected],31\nBob,,42",
	"rules": {
		"name": {
			"required": true
		},
		"email": {
			"required": true
		}
	}
}'

    

Aplica regras de mapeamento e validação ao texto CSV enviado, e então retorna uma saída limpa no estilo CSV e resultados de validação



                                                                            
POST https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25195/clean+csv
                                                                            
                                                                        

Limpar CSV - Recursos do endpoint

Objeto Descrição
Corpo da requisição [Obrigatório] Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA


RESPOSTA DE EXEMPLO DA API

{"ok":true,"normalizedHeaders":["first_name","email"],"cleanedRows":[{"first_name":"Alice","email":"[email protected]"},{"first_name":"Bob","email":""}],"importReadyCsvText":"first_name,email\nAlice,[email protected]\nBob,\n","warnings":["Some rows failed validation during cleaning.","Row 3: email failed required"],"disclaimer":"This API analyzes and transforms CSV text for import preparation. Review cleaned data before using it in production systems."}

Limpar CSV - TRECHOS DE CÓDIGO


curl --location --request POST 'https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25195/clean+csv' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
	"csvText": "First Name,Email Address\nAlice,[email protected]\nBob,",
	"mapping": {
		"First Name": "first_name",
		"Email Address": "email"
	},
	"rules": {
		"email": {
			"required": true
		}
	}
}'

    

Retorna uma prévia das linhas CSV para que os usuários possam inspecionar os dados antes da importação



                                                                            
POST https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25196/csv+preview
                                                                            
                                                                        

Prévia do Csv - Recursos do endpoint

Objeto Descrição
Corpo da requisição [Obrigatório] Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA


RESPOSTA DE EXEMPLO DA API

{"ok":true,"firstRows":[{"name":"Alice","email":"[email protected]"},{"name":"Bob","email":"[email protected]"},{"name":"Cara","email":"[email protected]"}],"detectedHeaders":["name","email"],"normalizedPreview":[{"name":"Alice","email":"[email protected]"},{"name":"Bob","email":"[email protected]"},{"name":"Cara","email":"[email protected]"}],"issuesSummary":{"rowCount":3,"columnCount":2,"duplicateHeaders":[],"blankHeaders":[],"hasIssues":false},"disclaimer":"This API analyzes and transforms CSV text for import preparation. Review cleaned data before using it in production systems."}

Prévia do Csv - TRECHOS DE CÓDIGO


curl --location --request POST 'https://zylalabs.com/api/12804/csv+cleanup+and+column+mapping+api/25196/csv+preview' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
	"csvText": "name,email\nAlice,[email protected]\nBob,[email protected]\nCara,[email protected]"
}'

    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Limpeza de CSV e Mapeamento de Colunas API basta incluir seu token Bearer no cabeçalho Authorization.
Cabeçalhos
Cabeçalho Descrição
Authorization [Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Preços simples e transparentes

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

🚀 Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Recursos favoritos dos clientes

  • ✔︎ Pague apenas por requisições bem-sucedidas
  • ✔︎ Teste 7 dias gratis
  • ✔︎ Suporte multilíngue
  • ✔︎ Uma chave de API, todas as APIs.
  • ✔︎ Painel intuitivo
  • ✔︎ Tratamento de erros abrangente
  • ✔︎ Documentação amigável para desenvolvedores
  • ✔︎ Integração com Postman
  • ✔︎ Conexões HTTPS seguras
  • ✔︎ Alta disponibilidade

Limpeza de CSV e Mapeamento de Colunas API FAQs

Cada endpoint retorna dados estruturados relacionados à análise de CSV, mapeamento de colunas, validação, visualização e limpeza. As respostas podem incluir contagens de linhas e colunas, cabeçalhos detectados, cabeçalhos duplicados, cabeçalhos em branco, palpites sobre tipos de coluna, sugestões de mapeamento, erros em nível de linha, texto CSV limpo, linhas de visualização, avisos e isenções de responsabilidade

Os campos principais incluem `rowCount`, `columnCount`, `originalHeaders`, `normalizedHeaders`, `validRowsCount`, `invalidRowsCount` e `cleanedRows` Esses campos fornecem insights sobre a estrutura do CSV e o status de validação

Os parâmetros variam conforme o ponto de extremidade, mas geralmente incluem o texto CSV a ser analisado, especificações de mapeamento para colunas e regras de validação para linhas. Os usuários podem personalizar as solicitações especificando o conteúdo CSV e os campos de mapeamento desejados

Os dados de resposta estão organizados em formato JSON com um campo de nível superior `ok` que indica sucesso seguido de campos de dados relevantes como contagens cabeçalhos e resultados de validação Essa estrutura permite uma fácil análise e integração em aplicações

Casos de uso típicos incluem preparar arquivos CSV para importação, verificar campos obrigatórios antes do processamento, encontrar cabeçalhos duplicados ou em branco, visualizar linhas e mapear colunas de origem para campos de destino para fluxos de trabalho de importação de CSV

A API realiza verificações técnicas no texto CSV enviado, incluindo validação de campos obrigatórios, suposições de tipo, detecção de cabeçalhos duplicados, detecção de cabeçalhos em branco e validação em nível de linha. Os resultados podem incluir avisos e erros para itens que precisam de revisão antes da importação

Os usuários podem revisar os resultados da validação, erros em nível de linha, avisos, sugestões de mapeamento, pré-visualizar linhas e a saída CSV limpa para decidir o que precisa ser revisado antes da importação Os dados retornados podem apoiar a preparação da importação CSV, mas não garantem a aceitação por um sistema de destino

Padrões de dados padrão incluem contagens de linhas e colunas, cabeçalhos detectados, cabeçalhos normalizados, suposições de tipo, campos esperados ausentes, cabeçalhos duplicados, cabeçalhos em branco, erros de validação em nível de linha, linhas de pré-visualização, texto CSV limpo, avisos e isenções de responsabilidade

O endpoint Analisar CSV fornece contagem de linhas, contagem de colunas, cabeçalhos detectados, cabeçalhos duplicados, cabeçalhos em branco, tipos de dados inferidos, campos esperados ausentes, avisos e informações de isenção para o texto CSV enviado

O 'pontuação' na resposta de Colunas do Mapa indica o nível de confiança da sugestão de mapeamento entre as colunas de origem e os campos de destino Uma pontuação mais alta sugere uma melhor correspondência ajudando os usuários a tomar decisões informadas sobre quais mapeamentos aplicar

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas