Compress

Bem-vindo à documentação oficial do Compress, a API leve porém poderosa projetada para reduzir arquivos de planilha a uma fração de seu tamanho original com uma única requisição intuitiva. No mundo orientado a dados de hoje, equipes trocam constantemente planilhas que contêm desde listas simples até modelos financeiros complexos, e o volume desses arquivos pode rapidamente se tornar um custo oculto — uploads mais lentos, taxas de armazenamento aumentadas e tempos de processamento mais longos para sistemas downstream. O Compress resolve esses pontos problemáticos oferecendo um serviço nativo da nuvem que analisa inteligentemente a estrutura interna da sua planilha, elimina bagagens desnecessárias e reempacota o conteúdo em uma forma otimizada e compacta sem sacrificar a integridade dos dados ou a legibilidade. Esta página de documentação serve como sua única fonte de verdade, guiando‑o por tudo que você precisa saber para começar a usar a API de forma eficaz, desde autenticação e formatação de requisições até tratamento de erros e estratégias de boas práticas para processamento em lote. Seja você um engenheiro de backend experiente integrando pipelines de dados, um desenvolvedor front‑end que deseja melhorar a experiência de usuário ao enviar arquivos, ou um gerente de TI responsável por reduzir a sobrecarga de armazenamento em sua organização, este guia fornecerá instruções claras passo a passo, trechos de código em múltiplas linguagens e exemplos do mundo real que ilustram como alcançar os melhores resultados de compressão para uma grande variedade de formatos de planilha. Ao longo da documentação você encontrará seções dedicadas a considerações de segurança — como criptografia TLS, tokens JWT assinados e tratamento de dados em conformidade com GDPR — além de benchmarks de desempenho que demonstram latência e throughput típicos sob diferentes cargas de trabalho. Também incluímos um FAQ extenso que cobre cenários comuns, uma matriz de solução de problemas para diagnóstico rápido de incidentes e links para fóruns da comunidade onde você pode compartilhar insights com outros desenvolvedores que utilizam o Compress em produção. Ao final deste guia, você deverá sentir‑se confiante em configurar seus ambientes, enviar uma chamada de API corretamente formada e interpretar os payloads de resposta, para que possa integrar a compressão sem interrupções em seus fluxos de trabalho existentes e começar a ver economias tangíveis em custos de armazenamento e largura de banda de rede imediatamente. Mergulhe, explore as seções que correspondem ao seu papel e deixe o Compress lidar com o trabalho pesado de redução de dados para que você possa focar em construir aplicações mais ricas e responsivas.

Principais Funcionalidades

O núcleo da API Compress gira em torno de um conjunto rico de funcionalidades que tornam a redução de planilhas ao mesmo tempo simples e confiável. Primeiro e antes de tudo, o serviço suporta um amplo espectro de tipos de arquivo — incluindo Apple Numbers, arquivos CSV e TSV simples, bem como os formatos .xlsx e .xls do Microsoft Excel — para que você possa enviar praticamente qualquer planilha que encontrar sem precisar de uma etapa de pré-conversão. Nos bastidores, o mecanismo realiza uma otimização em múltiplas fases: normaliza a estrutura interna XML ou binária do arquivo, elimina estilos duplicados, mescla formatos de célula idênticos, remove linhas e colunas ocultas que não contêm dados e compacta objetos incorporados como imagens, gráficos e tabelas dinâmicas aplicando algoritmos de compressão sem perdas adaptados a cada payload. Além disso, a API detecta e elimina metadados redundantes, comentários e informações de versionamento que normalmente inflacionam o tamanho do arquivo mas raramente têm propósito funcional. Todas essas operações ocorrem em tempo real, entregando resultados em milissegundos para arquivos de até 50 MB, e escalando elegantemente para documentos maiores com controle de taxa e callbacks de progresso. A segurança está incorporada — cada requisição é transferida via HTTPS, e o serviço nunca retém uma cópia do seu arquivo além da curta janela de processamento, garantindo conformidade com regulamentações de privacidade rigorosas. Do ponto de vista do desenvolvedor, a API foi projetada para ser o mais fluida possível: um único POST ao endpoint `/compress` com o arquivo anexado como multipart/form-data devolve uma resposta JSON contendo a URL de download do novo arquivo, os tamanhos original e comprimido, e um checksum para verificação. Parâmetros opcionais permitem ajustar finamente o nível de compressão, preservar planilhas específicas ou liberar certos objetos incorporados caso você precise manter fidelidade total para aplicações downstream. SDKs abrangentes estão disponíveis para Python, Node.js, Java e Go, cada um expondo um método wrapper conciso — `compressSpreadsheet(filePath, options)` — que abstrai totalmente a camada HTTP. Documentação detalhada de limites de taxa e endpoints de upload em massa permitem processar milhares de arquivos por hora sem sobrecarregar sua infraestrutura, enquanto a lógica de retry integrada e o tratamento de back-off exponencial mantêm seus pipelines robustos contra interrupções temporárias de rede. Em resumo, a API Compress oferece uma solução rápida, segura e amigável ao desenvolvedor que reduz a pegada de armazenamento de planilhas, acelera transferências de arquivos e simplifica fluxos de trabalho de gerenciamento de dados com apenas uma chamada simples.

Documentos

Parâmetros

AppRequest.CompressionLevel: O nível de compressão de um a nove (1 a 9)
UploadFileRequest.OperationId: Este é um ID de operação
UploadFileRequest.Files: Estes são arquivos que você precisa enviar para nossos serviços online; você pode preparar os dados da maneira que preferir, mas deve seguir o padrão do input file HTML.

Usar o Endpoint

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

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.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 Download

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