Mídia

Faça upload de um arquivo uma vez e reutilize o id em vários envios de mídia — mais rápido do que reenviar os bytes a cada mensagem. Também é possível baixar mídias recebidas.

Sua API key (para testar aqui)

Gere uma chave em Painel → API Keys. A chave fica só no seu navegador (localStorage) e nunca aparece nos exemplos de código.

Enviar (upload) mídia

messages:send

POST/v1/media

Faz upload de um arquivo (multipart/form-data, campo "file") e retorna um id reutilizável nos envios de mídia. O tamanho máximo depende do plano.

Resposta 200

{
  "id": "665f…",
  "url": "/v1/media/665f…",
  "mime": "image/jpeg",
  "size": 84210,
  "fileName": "foto.jpg"
}

curl -X POST "https://api.mandapi.net/v1/media" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE" \
  -F "file=@/caminho/para/arquivo.jpg"

▶ Testar no sandbox

file

Baixar mídia

messages:read

GET/v1/media/{id}

Baixa o conteúdo bruto de uma mídia sua (enviada ou recebida).

Campo	Tipo	Descrição
`id`obrigatório	string	Id da mídia.

Resposta: conteúdo binário do arquivo (200) com o Content-Type correspondente.

curl -X GET "https://api.mandapi.net/v1/media/665f0a1b2c3d4e5f6a7b8c9d" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE"