Midia

Quando o hub recebe mensagem com midia (message.received com type=image|audio|document|video), o content.media_id aponta pra um arquivo armazenado no MinIO. Este endpoint streama o arquivo.

GET /v1/media/:id

GET /v1/media/01HZTQMEDIA...
Authorization: Bearer APP_KEY

200 OK stream binario com Content-Type correto (image/jpeg, audio/ogg, etc) + headers de cache.

Quem pode baixar

App so consegue baixar midia de mensagem que ela tem acesso:

• Outbound (a app mandou) — app_id da mensagem == app autenticada
• Inbound (alguem mandou pro chip) — app precisa de can_receive=true em app_chip_access no chip da mensagem

Caso contrario: 404 media-not-found.

Tamanho maximo

MEDIA_MAX_BYTES no env do hub (default 16MB). Acima disso, hub aborta o download e mensagem chega sem media_id.

Tempo de vida

Por enquanto, midia recebida fica em MinIO indefinidamente. Politica de retencao customizada esta em backlog (longo prazo).

Streaming pra cliente final

Se voce quer servir a midia pro browser do usuario final do seu app, proxy via seu backend (com sua sessao/cookies) e baixa via GET /v1/media/:id com sua api_key. Nao exponha a api_key do hub no front.