> Nenhuma instalação local do Excel. Nenhum servidor de conversão para manter. Transforme XLSX → PDF, Excel → CSV/JSON/imagens/HTML em chamadas REST simples — e tenha seu primeiro “conversor de planilhas na nuvem” funcionando em cerca de três minutos. “Converter essa planilha para um formato diferente” é uma das necessidades mais comuns no desenvolvimento diário: - Equipes financeiras e jurídicas querem um relatório somente leitura e à prova de adulteração em PDF em vez de um .xlsx que qualquer um pode editar; - Equipes de dados precisam extrair dados tabulares para sistemas subsequentes como CSV / JSON; - Aplicativos web e móveis querem planilhas — e até mesmo gráficos — renderizados diretamente em PNG / SVG; - Portais querem trechos limpos de HTML / HTML-Table para incorporar; - Alguém precisa normalizar uma pilha de arquivos .xls / .xlsx / .csv / .ods em um formato. As respostas tradicionais — uma instalação local do Excel com macros, ou um componente COM pesado no seu próprio servidor — são difíceis de escalar e difíceis de manter entre plataformas. Aspose.Cells Cloud substitui tudo isso com uma pura API REST: carregue um arquivo, receba um arquivo de novo formato de volta. Este post percorre as três APIs de conversão expostas pelo ConversionController no microserviço Aspose.Cells Cloud (fonte: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), com exemplos executáveis em cURL, C# (.NET), Python e Java. — ## 1. O que a funcionalidade Converter pode fazer? ConversionController é o controlador dedicado à conversão / exportação de formato. Ele envolve a conversão de alta fidelidade em nível de mecanismo em três conjuntos de APIs HTTP: | # | Cenário | Endpoint típico | O que faz | | — | ———————————————————— | ———————————————— | —————————————————————————————————————————- | | 1 | Arquivo já no armazenamento em nuvem → baixar um novo formato | GET /v4.0/cells/{name}?format=pdf | Converte uma pasta de trabalho diretamente no armazenamento em nuvem e transmite o resultado de volta — arquivos grandes nunca precisam viajar para sua máquina | | 2 | Arquivo local → conversão online (funcionalidade principal) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | Você carrega o arquivo no corpo da solicitação (multipart); o servidor o converte e retorna o arquivo de resultado diretamente | | 3 | Arquivo em nuvem → salvar como um novo formato, de volta ao armazenamento em nuvem | PUT /v4.0/cells/{name}/saveas?format=pdf | O arquivo convertido é gravado diretamente de volta no armazenamento em nuvem — ideal para pipelines automatizados | > Nota de implementação: as rotas de origem usam o prefixo v{version}/cells com a versão da API 4.0, então chamadas ao vivo parecem https://api.aspose.cloud/v4.0/cells/.... ### A granularidade da conversão vai muito além de “o arquivo inteiro” Além de converter uma pasta de trabalho inteira, o controlador pode exportar um único elemento: - Uma planilha específica → PDF / imagem / CSV / JSON / HTML - Um intervalo de células específico (por exemplo, A1:C12) → PDF / imagem / CSV / JSON / HTML - Uma tabela específica → PDF / imagem / CSV / JSON / HTML - Um gráfico específico → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF Assim, você nunca precisa converter uma pasta de trabalho de 50 MB apenas para pegar um gráfico — converta apenas o que você precisa e economize largura de banda e computação. — ## 2. Quais formatos são suportados? Com base no registro ExportData embutido no controlador, a matriz de conversão se parece aproximadamente com isto: | Tipo | Formatos | | —————————————– | ———————————————————————————————————————- | | Importar e exportar (bidirecional) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | Apenas exportação | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL, etc. | Em resumo: conversões de planilha para planilha de todos os tipos, mais toda a família de saídas de planilha → PDF / imagem / dados da web — tudo por trás de uma única interface de API. — ## 3. Duas coisas que você precisa antes de começar 1. Registre uma conta gratuita no Painel do Aspose Cloud e crie um Aplicativo para obter um Client ID e Client Secret (os SDKs trocam isso por um JWT automaticamente — não é necessário construir cabeçalhos de autenticação você mesmo). 2. Instale o SDK para a linguagem de sua escolha: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — nota: NÃO está no Maven Central, então o repositório Aspose abaixo é necessário --> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://repository.aspose.cloud/repo/</url> </repository> </repositories> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-cells-cloud</artifactId> <version>26.8</version> </dependency> > Nenhum SDK necessário? Tudo é pura REST, então cURL funciona tão bem quanto (veja abaixo). — ## 4. Cenário 1: Converter um arquivo Excel local online (a API Convert principal) Este é PUT /v4.0/cells/convert/spreadsheet — a API “Converter” de destaque: carregue seu arquivo local no corpo da solicitação, o servidor o converte e transmite o novo arquivo de volta. Nada é persistido no armazenamento em nuvem e nenhuma cópia de upload permanece — perfeito para momentos de “apenas converta isso para mim”. ### ① cURL bash # 1) Primeiro, obtenha um token curl -X POST "https://api.aspose.cloud/connect/token" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" # 2) XLSX -> PDF curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -F "file=@Book1.xlsx" \ -o Book1.pdf Troque format por csv, json, png, xlsx… e você obtém esse formato. Um parâmetro, um formato de saída. ### ② C# / .NET csharp using Aspose.Cells.Cloud.SDK.Api; using Aspose.Cells.Cloud.SDK.Request; var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); var request = new ConvertSpreadsheetRequest( spreadsheet: "C:/invoices/Book1.xlsx", // caminho do arquivo local format: "pdf"); // destino: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // fluxo do arquivo convertido using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // Ainda mais simples: aponte o SDK para um caminho de saída e deixe-o gravar o arquivo // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > Precisa de um trabalho em lote? Coloque isso em um loop sobre um diretório e você terá “converter toda a pasta XLSX → PDF”. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # XLSX local -> PDF, resultado gravado localmente instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # Outros formatos: basta alterar o parâmetro — json / csv / xlsx / png ... ### ④ Java java import com.aspose.cloud.cells.api.CellsApi; import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest; import java.io.File; public class ConvertDemo { public static void main(String[] args) throws Exception { CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest(); req.setSpreadsheet("C:/invoices/Book1.xlsx"); // caminho do arquivo local req.setFormat("pdf"); // destino: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // resultado convertido como um arquivo out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("Convertido: " + out.getAbsolutePath()); } } Quatro linguagens, uma ação: dê um caminho + um parâmetro de formato → receba o arquivo de destino de volta. Esse é o grande atrativo da API Convert — zero dependência do Excel no lado do chamador, sem modelos, sem componentes COM. — ## 5. Cenário 2: Converter um arquivo armazenado na nuvem diretamente Quando um arquivo já está no Armazenamento em Nuvem Aspose (ou seu armazenamento de objetos), você não precisa baixar/carregar arquivos grandes — a conversão acontece na nuvem, minimizando a transferência de dados e melhorando o desempenho em grandes pastas de trabalho: bash # nuvem Book1.xlsx -> PDF, baixado localmente curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=pdf" \ --data-urlencode "folder=Reports" \ -o Book1.pdf python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # Converta uma pasta de trabalho armazenada na nuvem diretamente para PDF instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) Você também pode explorar um único elemento — por exemplo, renderizar “o 3º gráfico na Planilha1” como PNG (versão de armazenamento em nuvem): bash # gráfico -> PNG curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=png" \ -o chart.png Endpoints granulares em nuvem à vista: | Alvo | Endpoint | Exemplo format | | —————- | ——————————————————- | —————————– | | Pasta de trabalho inteira | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | Planilha única | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | Intervalo único | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | Tabela única | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | Gráfico único | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. Cenário 3: SaveAs — escreva o resultado de volta no armazenamento em nuvem Quando você deseja que o arquivo convertido seja persistido de volta no armazenamento em nuvem (em vez de baixado), use PUT /v4.0/cells/{name}/saveas. É uma combinação natural para automação, como “exportar o relatório de hoje para PDF para arquivamento, todos os dias”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import SaveSpreadsheetAsRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") instance.save_spreadsheet_as( SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports")) # Resultado é salvo diretamente no armazenamento em nuvem; retorna CellsCloudResponse(Code=200, Status="OK") Você pode passar opções de salvamento detalhadas através do corpo da solicitação SaveOptionsData, e controlar nome do arquivo de saída, armazenamento de saída, fontes personalizadas, região/locale, senha, etc. via parâmetros de consulta — mais sobre isso nas Detalhes de engenharia abaixo. — ## 7. Mais endpoints “online convert” prontos para uso Além das conversões em nível de pasta de trabalho acima, o controlador expõe um conjunto completo de endpoints dedicados arquivo local → alvo específico (mesmo upload no corpo da solicitação como no Cenário 1), que são mais granulares e mais econômicos em largura de banda: | Objetivo | Endpoint (PUT, prefixo /v4.0/cells/convert/) | | ————————————————— | ——————————————————————————————————– | | Pasta de trabalho → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | Planilha → PDF / JSON / CSV / HTML / HTML-Table | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | Planilha → imagem | worksheet/image?worksheet=Sheet1&format=png | | Intervalo → PDF / CSV / HTML / JSON / imagem | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | Tabela → PDF / CSV / HTML / JSON / imagem | table/pdf, table/csv, table/html, table/json, table/image | | Gráfico → imagem / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | Por exemplo, “exportar apenas este intervalo como CSV para o sistema subsequente”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "worksheet=Sheet1" \ --data-urlencode "range=A1:C100" \ -F "file=@data.xlsx" \ -o data.csv Esses endpoints usam o mesmo padrão de upload no corpo que convert/spreadsheet. No SDK .NET, os casos de gráfico têm wrappers tipados que mapeiam para essas rotas v4.0 — ConvertChartToImage (convert/chart/image) e ConvertChartToPdf (convert/chart/pdf). As variantes worksheet/*, range/* e table/* ainda não têm wrapper v4.0, então chame-as via REST puro exatamente como o cURL acima faz. — ## 8. Detalhes de engenharia & tratamento de erros ### Opções de conversão que vale a pena conhecer (parâmetros de consulta) - password — abra pastas de trabalho protegidas por senha; - fontsLocation / suporte a fontes personalizadas — mantenha os glifos corretos ao renderizar PDF/imagens; - ajuste automático de linhas/colunas, e se imprimir cabeçalhos de linha/coluna (printHeadings), configuração de região/página (region), etc.; - lado de saída: outPath / outStorageName decidem onde o resultado fica no armazenamento em nuvem. ### Códigos de erro (o contrato que o controlador documenta) | Status | Significado | Causa típica | | ——- | ————- | ———————————————————– | | 400 | Solicitação inválida | URL / parâmetros inválidos, ou um format não suportado | | 401 | Não autorizado | Falha na autenticação ou nenhuma credencial válida foi fornecida | | 404 | Não encontrado | O arquivo de origem não é acessível no armazenamento em nuvem | | 500 | Erro do servidor | O serviço encontrou uma anomalia ao obter dados de conversão | ### Autenticação Todos os SDKs se autenticam automaticamente com OAuth 2.0 client_credentials e um JWT; ao usar cURL puro, chame /connect/token uma vez primeiro (veja o Cenário 1, ① acima). — ## 9. Por que Aspose.Cells Cloud Convert? - ✅ Zero dependências locais — sem Office/Excel, sem COM. Chamável de qualquer linguagem e qualquer plataforma (Linux, contêineres, sem servidor); - ✅ Renderização de alta fidelidade — alimentada pelo mecanismo Aspose.Cells, portanto, fórmulas, gráficos, estilos e paginação são renderizados com qualidade profissional em PDF/imagens; - ✅ Nativo da nuvem — arquivos podem permanecer na nuvem durante a conversão para evitar o envio de grandes cargas; conversão puramente online não precisa de armazenamento em nuvem algum; - ✅ Granularidade flexível — pasta de trabalho / planilha / intervalo / tabela / gráfico: converta exatamente a parte que você precisa; - ✅ Uma forma em todos os SDKs — os exemplos de cURL, .NET, Python e Java mapeiam 1:1, então você pode literalmente copiar o padrão que gosta. Comece agora: registre-se no Painel do Aspose Cloud, crie um Aplicativo, coloque suas credenciais em qualquer snippet acima e execute-o — você terá seu próprio “conversor de Excel na nuvem” em minutos. Achou isso útil? Dê uma estrela, adicione aos favoritos ou compartilhe — e nos conte sobre seus próprios casos de uso de conversão de planilhas nos comentários.