Saltar al contenido principal
GET
/
api
/
chat
/
base64
/
:instance
Media en base64
curl --request GET \
  --url https://api.example.com/api/chat/base64/:instance
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Lee la media ya almacenada localmente (después de la ingestión) y devuelve el contenido en base64. Funciona para imágenes, videos, audios, documentos y stickers.
Solo los mensajes cuya media ya fue descargada y persistida por el pipeline de ingestión devuelven datos aquí. Si la media aún no existe en el almacenamiento, la respuesta es 404.

​
Ejemplo

curl -X GET "https://ryzeapi.cloud/api/chat/base64/$Instance_Name?messageId=3EB08FCF27E532F1B0F5" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

La respuesta repite message_id, trae mime_type y media_type (categoría general: image, video, audio, document, sticker) y devuelve en base64 los bytes brutos del media ya codificados, listos para escribir a un archivo, subir a otro lado o mostrar inline. El payload puede ser grande para videos/audios largos.
200 OK
{
  "success": true,
  "message": "Base64 retrieved successfully",
  "message_id": "3EB08FCF27E532F1B0F5",
  "mime_type": "image/jpeg",
  "media_type": "image",
  "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEA..."
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Parámetros de consulta

​
messageId
string
requerido
ID del mensaje que contiene el media.

​
Cabeceras

NombreRequeridoEjemploDescripción
tokensí (o Authorization)a1b2c3d4-...TokenAccount o TokenInstance.

​
Respuestas de error

HTTPerror.messageCuándo ocurre
400Instance name is required,
400messageId query parameter is required,
401Invalid token,
404Instance not found,
404Message not found or no media availableMedia faltante o aún no descargada.
503Instance is not connected to WhatsApp,
Error 404
{
  "success": false,
  "error": { "message": "Message not found or no media available" }
}

​
Relacionados

Buscar mensaje

Recupera los metadatos antes de descargar.

Estado de entrega

Verifica entrega/lectura.