Media en base64

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"

await fetch(`https://ryzeapi.cloud/api/chat/base64/${process.env.Instance_Name}?messageId=3EB08FCF27E532F1B0F5`, {
  method: "GET",
  headers: {
    "token": process.env.Token_Instance
  }
});

import os, requests

requests.get(
    f"https://ryzeapi.cloud/api/chat/base64/{os.environ['Instance_Name']}?messageId=3EB08FCF27E532F1B0F5",
    headers={"token": os.environ["Token_Instance"]}
)

package main

import (
    "net/http"
    "os"
)

func main() {
    req, _ := http.NewRequest("GET", "https://ryzeapi.cloud/api/chat/base64/"+os.Getenv("Instance_Name")+"?messageId=3EB08FCF27E532F1B0F5", nil)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    http.DefaultClient.Do(req)
}

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

string

requerido

Nombre de la instancia.

Parámetros de consulta

string

requerido

ID del mensaje que contiene el media.

Cabeceras

Nombre	Requerido	Ejemplo	Descripción
`token`	sí (o `Authorization`)	`a1b2c3d4-...`	TokenAccount o TokenInstance.

Respuestas de error

HTTP	`error.message`	Cuándo ocurre
400	`Instance name is required`	,
400	`messageId query parameter is required`	,
401	`Invalid token`	,
404	`Instance not found`	,
404	`Message not found or no media available`	Media faltante o aún no descargada.
503	`Instance is not connected to WhatsApp`	,

Error 404

{
  "success": false,
  "error": { "message": "Message not found or no media available" }
}

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Media en base64

Descripción

Ejemplo

Respuesta exitosa

Parámetros de ruta

Parámetros de consulta

Cabeceras

Respuestas de error

Relacionados

Buscar mensaje

Estado de entrega

​Descripción

​Ejemplo

​Respuesta exitosa

​Parámetros de ruta

​Parámetros de consulta

​Cabeceras

​Respuestas de error

​Relacionados

Buscar mensaje

Estado de entrega

Descripción

Ejemplo

Respuesta exitosa

Parámetros de ruta

Parámetros de consulta

Cabeceras

Respuestas de error

Relacionados