Conversão

A API de Metadados é um serviço desenvolvido especificamente para desenvolvedores, que coloca o controle total sobre os metadados de arquivos de planilhas ao seu alcance com apenas uma única solicitação HTTP. Seja lidando com formatos de escritório clássicos como Excel (.xlsx, .xls), arquivos delimitados simples como CSV (.csv) e TSV (.tsv), ou até mesmo documentos Apple Numbers (.numbers), a API abstrai as complexidades da análise de arquivos e permite ler, adicionar ou modificar propriedades descritivas importantes em questão de milissegundos. Imagine poder processar em lote milhares de relatórios, conjuntos de dados de pesquisa ou demonstrações financeiras, enriquecendo cada arquivo com um conjunto consistente de informações do autor, títulos, assuntos, descrições, listas de palavras‑chave e até coleções de tags personalizadas que sua própria aplicação define. Esse nível de automação não só economiza incontáveis horas de edição manual, como também garante que cada arquivo que você entrega a clientes, colaboradores ou sistemas de arquivamento contenha exatamente os metadados necessários para indexação, conformidade e descobribilidade. O serviço funciona aceitando tanto os bytes brutos do arquivo quanto uma URL apontando para um documento hospedado na nuvem, e então devolve um novo arquivo totalmente formado com as alterações de metadados solicitadas, sem alterar o layout original dos dados ou as fórmulas.

Principais Funcionalidades

Como a API é sem estado, você pode integrá‑la facilmente em pipelines CI/CD, trabalhos em lote no servidor ou widgets JavaScript no cliente, garantindo que cada exportação de um aplicativo web ou cada backup periódico contenha as informações corretas de proveniência. A segurança está incorporada: todas as chamadas são feitas via TLS, os payloads são criptografados de ponta a ponta, e a API suporta autenticação por chave de API ou OAuth 2.0, permitindo limitar o acesso apenas a serviços confiáveis. O mecanismo subjacente utiliza bibliotecas de análise altamente otimizadas para cada formato suportado, garantindo que até mesmo grandes pastas de trabalho do Excel com centenas de planilhas sejam processadas rapidamente; a maioria das solicitações típicas é concluída em menos de 200 ms. Na prática, isso significa que você pode criar um botão “Adicionar Metadados” perfeitamente integrado ao seu produto, que envia o arquivo ao serviço, recebe a versão enriquecida e a disponibiliza para download imediato — tudo sem que o usuário saia da interface. A API também devolve logs de operação detalhados, permitindo que os desenvolvedores verifiquem programaticamente se os campos esperados foram atualizados, revertam mudanças se necessário ou acionem etapas adicionais de processamento com base em valores de tags personalizadas. Ao oferecer um ponto final REST uniforme e independente de linguagem, a API de Metadados elimina a necessidade de os desenvolvedores manterem múltiplas bibliotecas específicas de formato, reduz a sobrecarga de manutenção e assegura compatibilidade futura à medida que novos padrões de planilhas surgem. Seja você um fornecedor SaaS que deseja incorporar informações de licenciamento, uma instituição de pesquisa catalogando conjuntos de dados ou uma empresa automatizando a conformidade de documentos, esta API oferece uma maneira rápida, segura e escalável de enriquecer seus arquivos com uma única chamada simples.

Documentos

Parâmetros

AppRequest.Metadata: Com PropertyName e PropertyValue
AppRequest.MetadataJson: Se você não estiver usando a estrutura de Metadados, então deve usar o tipo de dados json.
UploadFileRequest.OperationId: Estes são arquivos que você precisa enviar para nossos serviços online; pode preparar os dados da forma que desejar, mas eles devem seguir o padrão do input de arquivo HTML.
UploadFileRequest.Files: Estes são arquivos que você precisa enviar para nossos serviços online; pode preparar os dados da forma que desejar, mas eles devem seguir o padrão do input de arquivo HTML.

Usar o Endpoint

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

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -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 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 poderá usá‑lo ou simplesmente encaminhá‑lo para a próxima etapa do seu fluxo de trabalho.