Upload de Arquivos

Este endpoint permite que você faça upload de arquivos para a plataforma iApp GO.

Upload de Arquivos

Este endpoint permite que você faça upload de arquivos para a plataforma iApp, que podem posteriormente ser usados para envio de mensagens com mídia via WhatsApp.

URL Base

A URL base padrão é https://go.api.iappbr.com/api/v1/, seguida pelo endpoint específico do caminho.

Endpoint

POST /canal/{canalID}/upload

Requisição

Cabeçalhos

• Authorization: Bearer SEU_TOKEN_AQUI

• Content-Type: application/json

Corpo da Requisição

Campo	Tipo	Descrição
file_data	string	Arquivo codificado em base64 como data URL (formato data:mime/type;base64,DATA). Obrigatório.
file_name	string	Nome do arquivo com extensão. Obrigatório.
file_type	string	Tipo do arquivo: "document", "image", "audio" ou "video". Obrigatório.
description	string	Descrição do arquivo. Opcional.

Exemplo de Requisição

curl -X POST https://go.api.iappbr.com/api/v1/canal/12345/upload \
-H 'Authorization: Bearer SEU_TOKEN_AQUI' \
-H 'Content-Type: application/json' \
-d '{
  "file_data": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD...",
  "file_name": "exemplo.jpg",
  "file_type": "image",
  "description": "Imagem de exemplo"
}'

Resposta

Código de Sucesso

200 OK

Exemplo de Resposta de Sucesso

{
  "status": "success",
  "file_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "file_url": "https://cdn.iapp.com/empresa/123/api-uploads/f47ac10b-58cc-4372-a567-0e02b2c3d479.jpg",
  "file_type": "image",
  "mime_type": "image/jpeg",
  "file_size": 102400,
  "file_name": "exemplo.jpg",
  "created_at": 1681569325
}

Para arquivos de áudio, a resposta também inclui:

"duration": 15

Erros Possíveis

Status	Erro	Descrição
400	Parâmetros inválidos	Ocorre quando os parâmetros da requisição estão ausentes ou em formato incorreto.
400	Dados do arquivo não fornecidos	Ocorre quando o campo file_data está vazio.
400	Formato de dados do arquivo inválido	Ocorre quando o arquivo enviado não está no formato Data URL esperado (data:...).
400	Não foi possível decodificar os dados do arquivo	Ocorre quando há um problema na decodificação do conteúdo base64 do arquivo.
400	Tipo de arquivo não suportado	Ocorre quando o valor de file_type não é um dos tipos suportados ou não corresponde ao MIME type detectado.
500	Erro ao fazer upload do arquivo para o CDN	Ocorre quando há falha no upload do arquivo para o armazenamento na nuvem.

Tipos de Arquivos Suportados

• document: Qualquer tipo de documento (PDF, DOC, DOCX, XLS, XLSX, etc.)

• image: Imagens (JPEG, PNG, GIF, etc.)

• audio: Arquivos de áudio (MP3, OGG, etc.)

• video: Arquivos de vídeo (MP4, etc.)

Observações

• O tamanho máximo do arquivo depende do tipo:

  • Imagem: até 5 MB

  • Documento: até 100 MB

  • Áudio: até 16 MB

  • Vídeo: até 16 MB

• Para arquivos de áudio, a duração é calculada automaticamente e retornada na resposta.

• O URL retornado deve ser usado nos endpoints de envio de mídia (imagem, documento, áudio, vídeo).