Obtener media

Obtén una URL de descarga nueva y la metadata de un archivo de media adjunto a un mensaje, como un documento enviado por un contacto.

GET/media/:id

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes gestionar tus API keys desde la sección Dev Tools del panel.

Parámetros de ruta

ParámetroTipoObligatorioDescripción
idIntegerObligatorioId numérico del item de media, tal como se retorna en el array media de los payloads de mensajes y del webhook message_created.

Ejemplo de solicitud

bash
curl -X GET "https://api.eclecticlabs.com/api/external/v2/media/482" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json
{
  "media": {
    "id": 482,
    "url": "https://storage.googleapis.com/eclectic-media/documents/6f9a...c2.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Expires=7200&...",
    "filename": "cotizacion.pdf",
    "contentType": "application/pdf",
    "expiresAt": "2026-08-24T20:15:00Z"
  }
}

Notas

  • Los ids de media provienen del array media retornado por GET /contacts/:uuid/messages y por el webhook message_created.
  • url es una URL firmada válida por 120 minutos; expiresAt indica cuándo expira. Llama a este endpoint nuevamente para obtener una URL nueva.
  • filename y contentType pueden ser null cuando la plataforma no los provee (p. ej. fotos o notas de voz). expiresAt es null para media alojada en URLs públicas permanentes.
  • Errores posibles: 401 (API key inválida o faltante), 404 (media no encontrada o pertenece a otro negocio).