Clear

A Clear Spreadsheet API foi projetada para ser a solução definitiva para desenvolvedores que precisam eliminar programaticamente elementos indesejados de arquivos de planilha em uma única chamada confiável. Esta página de documentação serve como seu guia abrangente, conduzindo‑o por tudo o que é necessário para começar a integrar o serviço em suas aplicações com confiança. Começamos com uma visão geral dos conceitos centrais da API, explicando como o serviço interpreta diferentes formatos de planilha – desde arquivos modernos Office Open XML (.xlsx) até binários legados do Excel (.xls), além de Apple Numbers, CSV, TSV e diversas outras representações tabulares. Compreender essas nuances de tipo de arquivo é essencial, pois cada formato armazena hyperlinks, imagens, gráficos e objetos incorporados em estruturas distintas; a Clear API abstrai essas complexidades e apresenta uma interface uniforme que funciona em todas elas.

Principais Funcionalidades

Em seguida, você encontrará um walkthrough detalhado do fluxo de autenticação. A plataforma utiliza chaves de API padrão da indústria e tokens opcionais OAuth 2.0 para garantir que apenas clientes autorizados possam invocar operações de limpeza de dados. As melhores práticas de segurança, como rotação de chaves, lista branca de IPs e transmissão criptografada via HTTPS, são abordadas em profundidade, assegurando que você possa proteger tanto sua infraestrutura quanto os dados dos usuários finais. Após a autenticação, a seção “Getting Started” oferece um exemplo de código rápido em várias linguagens (cURL, Python, JavaScript, .NET e Java), mostrando como montar o payload da solicitação, anexar o arquivo de planilha e interpretar a resposta. O exemplo demonstra a requisição mais enxuta possível – apenas sua chave de API, os dados do arquivo e, opcionalmente, uma lista de tipos de elementos a limpar – evidenciando a promessa da API de “uma chamada simples”.

Documentos

Parâmetros

format: O nome da operação, por exemplo: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
AppRequest.OperationTables: O nome da operação, por exemplo: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
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 eles devem seguir o padrão do campo de entrada HTML.

Usar o Endpoint

Envie uma solicitação que inclua os arquivos e o token de acesso Clear API

curl -X 'POST' \ 'https://api.sheetize.cloud/clear' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.OperationTables=clearHyperlinks' \ -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 solicitação que inclua o nome do arquivo e o nome da pasta para Download API

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