Custodia de documentos

/custody

Esta API permite la custodia de archivos con las siguientes características:

• Tipos de archivo admitidos: PDF

• Tiempo de custodia: 5 años

---

Uso

Obtención de URLs de carga y descarga Para cargar un archivo será necesario obtener la URL de carga. Para obtenerla, realice la siguiente solicitud:

bash

curl --location '{IDENTITY_API_BASE_URL}/services/custody/upload' \
--header 'x-api-key: {API_KEY}'

Ejemplo de respuesta:

200 OK

Content-Type: application/json

json

{
    "uploadUrl": "{UPLOAD_URL}",
    "downloadUrl": "{DOWNLOAD_URL}"
}

Campo	Descripción
uploadUrl	URL para cargar el archivo. Válida por 5 minutos.
downloadUrl	URL pre-firmada para descargar el archivo. Válida por 5 años.

---

Carga de documentos

Para cargar un documento después de obtener la URL de carga:

bash

curl --location --request PUT '{UPLOAD_URL}' \
--header 'Content-Type: application/pdf' \
--data '{FILE_LOCATION}'

Ejemplo de respuesta:

200 OK

---

Descarga de documentos

Para descargar un archivo utilizando la URL de descarga:

bash

curl --location '{DOWNLOAD_URL}'

Ejemplo de respuesta:

302 FOUND

Content-Type: application/pdf Location: {DIRECT_DOWNLOAD_URL}

Nota Cuando se utiliza la URL de descarga en un navegador, el navegador seguirá la redirección de forma transparente para el usuario.

Precaución La URL de descarga contiene un token JWT, válido por 5 años. Si se pierde la URL de descarga, no será posible recuperar el archivo.