Descargar Archivo

POST

https://app.firmeasy.legal/api/v1/digital/archivo/download

Descargar Archivo

Este endpoint permite descargar un archivo digital específico. La descarga se procesa a partir del identificador único del archivo proporcionado en el cuerpo de la petición.

Autorización

Este recurso está protegido. Debes incluir tu token de acceso en el encabezado de la petición.

Parámetro	Tipo	Descripción	Límites
`Authorization`	string	Token de acceso (Bearer token).	Obligatorio
`Content-Type`	string	Especifica el formato de la petición.	application/json

Authorization

string

Token de acceso (Bearer token).

Límites:Obligatorio

Content-Type

string

Especifica el formato de la petición.

Límites:application/json

Parámetros de la Petición

Campos Obligatorios

Los campos marcados con un asterisco (*) son obligatorios y deben ser proporcionados en la solicitud. Los demás campos son opcionales.

Envía el identificador del archivo en formato JSON para iniciar la descarga.

Parámetro	Tipo	Descripción	Límites
`archivo_id`	string	Identificador único (UUID) del archivo que deseas descargar.	Obligatorio (Formato UUID)

archivo_id

string

Identificador único (UUID) del archivo que deseas descargar.

Límites:Obligatorio (Formato UUID)

Ejemplos de Implementación

cURL

curl -X POST [https://app.firmeasy.legal/api/v1/digital/archivo/download](https://app.firmeasy.legal/api/v1/digital/archivo/download) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "archivo_id": "1eebd53e-a10e-4ce8-a714-31ef4c8fabc0"
  }'

Node.js (Fetch)

const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer TU_TOKEN_AQUI");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "archivo_id": "1eebd53e-a10e-4ce8-a714-31ef4c8fabc0"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("[https://app.firmeasy.legal/api/v1/digital/archivo/download](https://app.firmeasy.legal/api/v1/digital/archivo/download)", requestOptions)
  .then((response) => response.blob()) // Los archivos se manejan como Blob
  .then((blob) => {
    // Lógica para descargar el archivo en el navegador/sistema
    console.log("Archivo recibido");
  })
  .catch((error) => console.error(error));

Respuesta

Este endpoint retorna un flujo binario (stream) del archivo solicitado.

200 OK: La descarga comenzará inmediatamente.
Headers: La respuesta incluirá cabeceras como Content-Type: application/pdf o similar dependiendo del tipo de archivo.

Códigos de Estado

Código	Estado	Descripción
`200`	OK	Descarga iniciada correctamente.
`401`	Unauthorized	Token ausente o inválido.
`404`	Not Found	No se encontró el archivo con ese ID.
`500`	Server Error	Falla interna en los servidores.