WSGetTareaMultimedia

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

---

Get Tarea Multimedia

POST/apidev/legacy/WSGetTareaMultimedia

AuthWSAutorizacion (body)

FormatoJSON

RespuestaHTTP 200 + Error

EstadoAvailable

Request Body

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

Response

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

Field	Type	Description
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.

Code Examples

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()

Example Response

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

---

Errors

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.

---

Related

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