Apidog

Plataforma Colaborativa All-in-one para Desenvolvimento de API

Design de API

Documentação de API

Depuração de API

Mock de API

Testes Automatizados de API

Como Fazer Upload e Enviar Arquivo Binário com Axios

O upload binário é frequentemente contrastado com o upload baseado em texto, onde os dados sendo enviados consistem em caracteres legíveis por humanos codificados em um conjunto de caracteres específico, como ASCII ou UTF-8.

Miguel Oliveira

Miguel Oliveira

Updated on novembro 29, 2024

Binário é um método de codificação de informações baseado em números binários. Ele utiliza a representação de valores binários (geralmente 0 e 1) para armazenar e processar todos os tipos de dados, incluindo texto, imagens, áudio, etc.

O sistema binário é o método de representação de dados mais básico em tecnologia da computação, pois o hardware subjacente do computador (como portas lógicas e flip-flops) só consegue reconhecer dois estados: ligado (1) e desligado (0).

💡
No Apidog, o upload binário envolve a criação de um objeto FormData para encapsular dados binários, como imagens ou arquivos. Utilizar a funcionalidade de upload de arquivos do Apidog simplifica o processo, melhorando a conveniência para desenvolvedores e a eficiência do fluxo de trabalho.
button

O que é Axios?

Axios é uma biblioteca popular de JavaScript usada para fazer requisições HTTP de navegadores da web ou ambientes Node.js. Ela fornece uma interface simples e consistente para enviar requisições HTTP assíncronas para endpoints REST e lidar com as respostas.

O que é um Arquivo Binário?

Um arquivo binário é um tipo de arquivo de computador que contém dados em um formato binário, que consiste em uma sequência de dígitos binários (bits) representando diversos tipos de dados, como código executável, imagens, áudio ou arquivos de vídeo. Diferente dos arquivos de texto, que armazenam dados em caracteres legíveis por humanos (por exemplo, ASCII ou Unicode), os arquivos binários armazenam dados em um formato otimizado para processamento e armazenamento em computador.

Quando você faz o upload de um arquivo binário, você transfere a sequência exata de dados binários de sua máquina local para um servidor remoto ou outro destino. Este processo é comumente utilizado no desenvolvimento de software para enviar arquivos de programas compilados, bibliotecas ou outros recursos necessários para o funcionamento de uma aplicação de software.

O upload binário é frequentemente comparado ao upload baseado em texto, onde os dados que estão sendo enviados consistem em caracteres legíveis por humanos codificados em um conjunto de caracteres específico, como ASCII ou UTF-8. O upload baseado em texto é mais adequado para transferir conteúdo textual, como arquivos de configuração, código-fonte ou documentos. Vamos simplesmente descrever o conceito de um arquivo binário de servidor.

Por que usar o formato binário para uploads?

As principais razões para usar dados binários ao enviar para o servidor são as seguintes:

  • Transmissão eficiente de dados: Dados binários são compactos, reduzindo o tamanho da transmissão e o uso de largura de banda.
  • Processamento de dados mais rápido: Servidores analisam dados binários mais rapidamente do que texto, melhorando a eficiência do processamento.
  • Integridade dos dados aprimorada: Dados binários são menos propensos a erros e podem ser verificados quanto à integridade durante a transmissão.
  • Suporte versátil: O formato binário acomoda vários tipos de dados, tornando-o flexível para diferentes tipos de uploads.

Enviar dados binários para o servidor pode melhorar a eficiência da transmissão e processamento de dados, proteger a integridade dos dados e suportar múltiplos tipos de dados. É uma forma comumente utilizada de representação de dados em comunicações em rede. Vamos usar o Apidog para entender melhor o upload de dados em formato binário.

Como fazer upload de arquivos binários de forma visual

No Apidog, precisamos enviar dados binários como imagens, áudio ou vídeos. O método principal para isso é através do upload de arquivos. Ao selecionar Binário como o tipo de Corpo, você geralmente terá a opção de carregar um arquivo em vez de inserir dados binários diretamente. Isso ocorre porque inserir dados binários diretamente em uma caixa de texto, especialmente para arquivos grandes, é inconveniente.

button

Para enviar dados binários via Apidog:

  1. Abra o Apidog e crie uma nova requisição. Depois de criar um projeto HTTP, clique no ícone "+" para criar uma nova requisição. Defina o método de requisição (por exemplo, POST) e preencha a URL solicitada.

2. Selecione o tipo de Corpo como Binário

Na interface de edição da requisição, selecione a aba "Body", selecione "binário" na opção "Binário" sob a aba "Body" e salve após a configuração ser completada.

3. Você pode escolher qualquer tipo de mídia, como uma imagem, vídeo ou áudio. Escolha o tipo de requisição PUT, insira sua API, escolha seu ambiente, mude a URL base para o endereço do seu servidor, salve sua requisição e clique no botão de enviar.

4. Você pode verificar a resposta obtida da sua requisição.

Como fazer upload e enviar um arquivo binário no Axios

Fazer upload de dados em formato binário para o servidor, como fazer upload de arquivos, também pode ser alcançado através da biblioteca Axios. Aqui está uma explicação passo a passo:

1. Crie um objeto FormData

Primeiro, você precisa adicionar seus dados binários ao objeto FormData. FormData é um método usado para codificar dados em uma mensagem e enviá-los ao servidor de uma forma que simula o comportamento de envio de formulário.

let formData = new FormData();
// Suponha que você tenha um elemento de entrada de arquivo ou um objeto Blob para fazer o upload
formData.append('file', binaryData, 'filename.ext');

Aqui 'file' é o nome do campo do arquivo que você obtém do lado do servidor, binaryData é os dados binários que você deseja fazer upload (que pode ser um arquivo obtido de <input type="file"> ou qualquer objeto Blob), e 'filename.ext' é o nome do arquivo pretendido para ser salvo no servidor.

2. Configure o Axios

Em seguida, você precisa configurar a requisição Axios, especificamente os cabeçalhos. Como você está fazendo upload de um arquivo, é útil que o cabeçalho Content-Type seja definido como 'multipart/form-data'. Na maioria dos casos, o navegador trata isso automaticamente quando você usa o FormData.

const config = {
  headers: {
    // `Content-Type` será automaticamente definido pelo navegador
    'Accept': 'application/json', // Apenas um exemplo, ajuste conforme necessário
  },
};

3. Envie uma requisição

Por fim, use o Axios para enviar o objeto formData.

axios.post('seu-endpoint-do-servidor', formData, config)
  .then(response => {
    // Lide com a resposta bem-sucedida
    console.log(response.data);
  })
  .catch(error => {
    // Lide com erros
    console.error(error);
  });

Aqui 'seu-endpoint-do-servidor' é o endpoint do servidor para o qual você deseja fazer upload de arquivos.

Fazer upload de dados binários para o servidor envolve criar um objeto FormData, adicionar seus arquivos (ou outros dados binários) a ele e, em seguida, enviar o objeto através do Axios. Certifique-se de que a configuração do Axios está configurada corretamente, especialmente a seção de cabeçalhos de configuração, e, em seguida, lide com as respostas ou erros.

Observe que o servidor também precisa ser configurado corretamente para receber requisições multipart/form-data e lidar com arquivos enviados. Isso geralmente envolve configurar o parsing do corpo da requisição, a lógica de armazenamento de arquivos, etc., que não será descrito em detalhes.

Conclusão

Através dos passos acima, podemos facilmente enviar dados binários no Apidog, seja imagens, áudio, vídeo ou outros tipos de arquivos. Usando a função de upload de arquivos fornecida pelo Apidog, podemos facilmente enviar conteúdo de arquivos locais para a API de destino para realizar a transmissão e teste de dados binários. Isso proporciona conforto aos desenvolvedores ao desenvolver e testar APIs, ao mesmo tempo que melhora a eficiência do trabalho.

button
Como acessar a API do Claude 3.7 Sonnet e testar usando ApidogTutoriais

Como acessar a API do Claude 3.7 Sonnet e testar usando Apidog

Se você está empolgado com o último lançamento da Anthropic, Claude 3.7 Sonnet, e quer explorar suas capacidades através da API enquanto o testa com o Apidog, você está no lugar certo. 💡Antes de começarmos, deixe-me fazer uma rápida observação: baixe o Apidog gratuitamente hoje e otimize seu processo de teste de API, especialmente para explorar os poderosos recursos do Claude 3.7 Sonnet—perfeito para desenvolvedores que desejam testar modelos de IA de ponta como este!botão Vamos começar com a

@apidog

fevereiro 25, 2025

Como passar o x-API-key no cabeçalho?Tutoriais

Como passar o x-API-key no cabeçalho?

Desvende os segredos da segurança eficaz de APIs, dominando como passar x-API-key nos cabeçalhos. Este guia abrangente revelará a importância desse processo e como ferramentas como o Apidog podem facilitar seus esforços. Continue lendo para garantir que suas interações com a API permaneçam seguras!

Miguel Oliveira

agosto 12, 2024

Como corrigir o erro HTTP 405 Método Não Permitido no PostmanTutoriais

Como corrigir o erro HTTP 405 Método Não Permitido no Postman

O código de erro HTTP 405 ocorre quando você tenta acessar um servidor usando uma chave de API ou token de acesso inválido ou ausente. Neste artigo, veremos mais sobre o erro 405 e como corrigi-lo.

Miguel Oliveira

agosto 11, 2024