WSGetTareaMultimedia

Descarga un archivo multimedia de una tarea por nombre de archivo y devuelve su contenido codificado en base64.

---

Obtener multimedia de tarea

POST/apidev/legacy/WSGetTareaMultimedia

AuthWSAutorizacion (body)

FormatoJSON

RespuestaHTTP 200 + Error

EstadoDisponible

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
WSAutorizacion	object	Sí	Credenciales de autenticación legacy.
WSAutorizacion.Guid	string	Sí	API key (GUID) de la compañía.
WSAutorizacion.Usuario	string	Sí	Usuario del web service.
WSAutorizacion.Password	string	Sí	Contraseña del usuario.
WSSDTFiltroTareaMultimedia	object	Sí	Filtro con el nombre del archivo a descargar.
WSSDTFiltroTareaMultimedia.Filename	string	Sí	Nombre del archivo a descargar. Vacío devuelve error.

Respuesta

Wrapper raíz WSSDTTareaMultimedia (objeto) con sobre de error.

Campo	Tipo	Descripción
WSSDTTareaMultimedia.Archivobase64	string	Contenido del archivo en base64 cuando hay éxito; "" en caso contrario. (Clave exacta Archivobase64, con b minúscula.)
WSSDTTareaMultimedia.Error	string	Sobre de error; "" cuando la operación fue exitosa.

Ejemplos de código

cURL

curl -s -X POST "https://$TENANT/apidev/legacy/WSGetTareaMultimedia" \
  -H "Content-Type: application/json" \
  -d '{
    "WSAutorizacion": {
      "Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "Usuario": "usuario@empresa.com",
      "Password": "contraseña"
    },
    "WSSDTFiltroTareaMultimedia": {
      "Filename": "foto_origen_103878.jpg"
    }
  }'

JavaScript

const res = await fetch(`https://${TENANT}/apidev/legacy/WSGetTareaMultimedia`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    WSAutorizacion: {
      Guid: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
      Usuario: 'usuario@empresa.com',
      Password: 'contraseña',
    },
    WSSDTFiltroTareaMultimedia: {
      Filename: 'foto_origen_103878.jpg',
    },
  }),
});
const data = await res.json();

Python

import requests

response = requests.post(
    f"https://{TENANT}/apidev/legacy/WSGetTareaMultimedia",
    json={
        "WSAutorizacion": {
            "Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "Usuario": "usuario@empresa.com",
            "Password": "contraseña",
        },
        "WSSDTFiltroTareaMultimedia": {
            "Filename": "foto_origen_103878.jpg",
        },
    },
)
data = response.json()

Ejemplo de respuesta

{
  "WSSDTTareaMultimedia": {
    "Archivobase64": "/9j/4AAQSkZJRgABAQEASABIAAD...",
    "Error": ""
  }
}

---

Errores

Este web service siempre responde HTTP 200. El error viaja en el campo WSSDTTareaMultimedia.Error del sobre (nunca como código 4xx/5xx). Cuando hay éxito, Error es "".

Valor de Error	Causa
GUID Inválido	El Guid no resuelve a una compañía válida (ciaid == 0).
URL Inválida	La URL de origen de la llamada no está autorizada (salvo admincloud@logicsat.com, que omite esta verificación).
Compañía inválida.	Compañía inválida en la rama interna de resolución (ciaid == 0).
Error: Debe ingresar el nombre del archivo.	Filename vacío.
No se encontraron registros que cumplan con los filtros ingresados	El archivo solicitado no fue encontrado (Azure devolvió ERROR).
<errores de validación>	Falla de validación de usuario/contraseña/permiso del web service.

---

Relacionado

• Introducción
• Modelo de Migración
• Matriz de Servicios