Comparação

Bem‑vindo ao hub oficial de documentação da API de Comparação, uma solução criada especificamente para transformar a tarefa muitas vezes tediosa de controle de versão de planilhas em um fluxo de trabalho simplificado e centrado no desenvolvedor. Seja você um analista de dados reconciliando relatórios trimestrais, uma equipe financeira monitorando revisões de orçamento ou um engenheiro de software incorporando capacidades de diff a um pipeline de dados maior, esta API foi projetada para encontrá‑lo onde está e eliminar a adivinhação ao identificar alterações em uma ampla variedade de formatos de planilha. No seu cerne, a API de Comparação segue um modelo simples, porém poderoso: você fornece dois arquivos‑fonte – sejam eles originados do Apple Numbers, de uma exportação CSV/TSV ou da onipresente suíte Excel (.xlsx, .xls) – e o serviço devolve um único arquivo de resultado que destaca cada adição, exclusão e modificação com indicadores visuais cristalinos. O foco na clareza não é um detalhe secundário; cada diferença é anotada de modo a refletir as convenções nativas das planilhas (fundos de célula coloridos, balões de comentário e marcadores de linha/coluna), permitindo que os usuários finais abram o resultado em sua aplicação preferida e compreendam instantaneamente o que mudou. Além do diff básico, a API preserva formatação original, fórmulas e tipos de dados, garantindo que a saída não seja apenas um relatório de texto simples, mas sim uma pasta de trabalho totalmente funcional pronta para análise ou distribuição adicional. Segurança e desempenho estão incorporados em cada requisição: todas as transferências de arquivos ocorrem sobre TLS 1.3, os arquivos são processados em containers isolados com limites rígidos de memória, e os resultados são tipicamente devolvidos em menos de um segundo para arquivos de até 10 MB, escalando suavemente para conjuntos de dados maiores por meio de streaming em blocos. A documentação que você está lendo está organizada para que você comece a usar a API em minutos – começando pela autenticação, passando pela construção da requisição e culminando nas melhores práticas para tratamento de erros, paginação e integração via webhooks. Ao longo do texto, você encontrará trechos de código em Python, JavaScript, Java e C#, demonstrando como uma única linha de código pode acionar uma comparação completa, além de um ambiente sandbox onde pode experimentar com arquivos reais sem deixar o navegador. Ao final deste guia, você terá um entendimento sólido de como incorporar comparações de planilhas confiáveis e de alta fidelidade em qualquer fluxo de trabalho, reduzir o tempo de revisão manual e capacitar as partes interessadas com registros de mudanças transparentes e auditáveis – tudo isso aproveitando uma API tão segura e rápida quanto fácil de usar.

Principais Funcionalidades

A API de Comparação possui um conjunto extenso de recursos que abordam os pontos de dor mais comuns encontrados ao reconciliar dados de planilhas entre plataformas diversas. Em primeiro lugar, a API oferece suporte a uma lista abrangente de formatos de arquivo: Apple Numbers (.numbers), arquivos de texto delimitados (CSV, TSV), Excel legado (.xls) e Excel moderno (.xlsx). Isso elimina a necessidade de ferramentas de pré‑conversão, permitindo que você envie os arquivos originais diretamente ao serviço. O motor de diff opera ao nível da célula, detectando alterações em valores, fórmulas e até atributos de formatação como estilo de fonte, sombreamento de célula e regras de validação de dados; cada variação é claramente destacada na pasta de trabalho resultante usando esquemas de cores personalizáveis, facilitando a interpretação por revisores não técnicos. Para conjuntos de dados em larga escala, a API oferece modo de comparação incremental, permitindo comparar apenas as linhas que foram adicionadas ou modificadas desde um ponto de referência anterior, reduzindo o tempo de processamento e a largura de banda. Além disso, você pode solicitar um resumo estruturado em JSON das mudanças além do arquivo visual de diff, habilitando automações posteriores como disparo de alertas, atualização de dashboards ou integração de mudanças em sistemas de controle de versão. Recursos de segurança incluem autenticação OAuth 2.0 com token bearer, chaves de API com escopo e whitelist opcional de IPs, enquanto os dados em repouso são criptografados com AES‑256. O serviço também segue as normas de conformidade GDPR e CCPA, proporcionando confiança ao lidar com informações pessoais ou financeiras sensíveis. Em termos de desempenho, a API foi projetada para baixa latência; graças ao dimensionamento horizontal e a algoritmos de diff em memória, a maioria das comparações termina em menos de um segundo para workbooks de tamanho padrão, com suporte a processamento assíncrono via webhooks para arquivos acima de 50 MB. Por fim, a experiência do desenvolvedor é prioridade: especificações OpenAPI completas, SDKs auto‑gerados, códigos de erro detalhados e cabeçalhos de taxa de limite em tempo real permitem integrar a API com o mínimo de atrito, enquanto nosso console sandbox e um vasto repositório de amostras demonstram implementações recomendadas para processamento em lote, pipelines CI/CD e funções serverless.

Documentos

Parâmetros

format: Um formato de arquivo de saída suportado.
UploadFileRequest.OperationId: Este é um ID de operação
UploadFileRequest.Files: Estes são arquivos que você precisa enviar para nossos serviços online; pode preparar os dados da maneira que preferir, mas eles devem seguir o padrão do campo de entrada HTML.

Use o Endpoint

Envie uma requisição que inclua os arquivos e o token de acesso API de Comparação

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
O serviço responderá com uma URL de download para o arquivo processado, neste exemplo é:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Envie uma requisição que inclua o nome do arquivo e o nome da pasta para API de Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Você receberá o arquivo e pode usá‑lo ou simplesmente encaminhá‑lo para a próxima etapa do seu fluxo de trabalho.