Generar Enlace de Archivo

POST

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

Generar Enlace de Archivo

Este endpoint permite generar un enlace temporal para compartir un archivo específico dentro del flujo de Firma Digital. Es una herramienta clave para habilitar la visualización o gestión externa de documentos sin necesidad de acceso permanente.

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 los siguientes parámetros en el cuerpo (body) de tu petición POST en formato JSON.

Parámetro	Tipo	Descripción	Límites
`archivo_id`	string	Identificador único (UUID) del archivo que deseas enlazar.	Obligatorio (Formato UUID)
`tiempo`	integer	Tiempo de validez o expiración del enlace generado.	Obligatorio (Número entero)

archivo_id

string

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

Límites:Obligatorio (Formato UUID)

tiempo

integer

Tiempo de validez o expiración del enlace generado.

Límites:Obligatorio (Número entero)

Ejemplos de Implementación

cURL

curl -X POST [https://app.firmeasy.legal/api/v1/digital/archivo/enlace](https://app.firmeasy.legal/api/v1/digital/archivo/enlace) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "archivo_id": "ad7e4811-bc1a-4b7f-a5c5-52aa144a3a86",
    "tiempo": 9
  }'

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": "ad7e4811-bc1a-4b7f-a5c5-52aa144a3a86",
  "tiempo": 9
});

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

fetch("[https://app.firmeasy.legal/api/v1/digital/archivo/enlace](https://app.firmeasy.legal/api/v1/digital/archivo/enlace)", requestOptions)
  .then((response) => response.json())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Códigos de Estado

Código	Estado	Descripción
`200`	OK	El enlace temporal fue generado correctamente.
`400`	Bad Request	Parámetros inválidos o formato de JSON incorrecto.
`401`	Unauthorized	Token ausente o inválido.
`404`	Not Found	No se encontró el archivo con el ID proporcionado.
`500`	Server Error	Falla interna en los servidores.