Download de mídia

Baixa o conteúdo de uma mensagem de mídia recebida. Os campos necessários são recebidos no payload do webhook quando uma mensagem de mídia chega.

Endpoint

POST /chat/download

Parâmetros

Nome	Tipo	Obrigatório	Descrição
directPath	string	Sim	Path do CDN recebido no webhook
mediaKey	string	Sim	Chave de decriptação (base64)
fileEncSha256	string	Sim	Hash do arquivo encriptado (base64)
fileSha256	string	Sim	Hash do arquivo original (base64)
fileLength	number	Sim	Tamanho do arquivo em bytes
mediaType	string	Sim	image, video, audio, document ou sticker
mimeType	string	Sim	MIME type do arquivo

Request

cURL

curl -X POST https://endpoint.wi.api.br/chat/download \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "directPath": "/v/t62.7161-24/32985611_1084...",
    "mediaKey": "dGVzdGtleWJhc2U2NA==",
    "fileEncSha256": "aGFzaGVuY3J5cHRlZA==",
    "fileSha256": "aGFzaG9yaWdpbmFs",
    "fileLength": 52480,
    "mediaType": "image",
    "mimeType": "image/jpeg"
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/chat/download", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    directPath: "/v/t62.7161-24/32985611_1084...",
    mediaKey: "dGVzdGtleWJhc2U2NA==",
    fileEncSha256: "aGFzaGVuY3J5cHRlZA==",
    fileSha256: "aGFzaG9yaWdpbmFs",
    fileLength: 52480,
    mediaType: "image",
    mimeType: "image/jpeg",
  }),
});

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/chat/download",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "directPath": "/v/t62.7161-24/32985611_1084...",
        "mediaKey": "dGVzdGtleWJhc2U2NA==",
        "fileEncSha256": "aGFzaGVuY3J5cHRlZA==",
        "fileSha256": "aGFzaG9yaWdpbmFs",
        "fileLength": 52480,
        "mediaType": "image",
        "mimeType": "image/jpeg",
    },
)

Response

{
  "data": "iVBORw0KGgoAAAANSUhEUgAA...",
  "mimeType": "image/jpeg"
}

O campo data contém o arquivo em base64.