Saltar al contenido principal
Version: 2.0

Introducción

La API de Archivos Binarios de Arai-Documentos es un servicio RESTful especializado en la gestión integral del ciclo de vida de archivos digitales. Permite a las aplicaciones y usuarios interactuar de forma segura y eficiente con documentos binarios, abarcando desde su creación hasta su eliminación, pasando por operaciones de consulta, mantenimiento y control de acceso.

Esta API está diseñada para garantizar la trazabilidad, integridad y disponibilidad de los archivos, cumpliendo con normativas de preservación digital y requisitos de auditoría. Cada archivo cuenta con metadatos asociados que facilitan su identificación, clasificación y gestión a lo largo del tiempo.

aviso

Un archivo binario NO tiene un proceso de autorización relacionado. Es decir, es un archivo que NO posee firma digital ni autorización alguna.

El flujo típico de uso incluye:

  • Creación del archivo y registro de metadatos.
  • Carga del contenido binario.
  • Finalización del archivo para dejarlo disponible a otras operaciones.
  • Consulta de información y descarga del binario.
  • Renovación de vigencia para extender su vida útil.
  • Solicitud y procesamiento de eliminación, preservando siempre los metadatos para auditoría.

A continuación se presenta un resumen de los principales endpoints disponibles:

MétodoDescripciónRecursoGuía
POSTCrear un nuevo archivo/archivosVER +
PUTAgregar contenido binario/archivos/{id}/binarioVER +
PUTFinalizar la carga del archivo/archivos/{id}/finalizarVER +
GETConsultar detalles del archivo/archivos/{id}VER +
GETDescargar el binario del archivo/archivos/{id}/binarioVER +
PUTRenovar la vigencia del archivo/archivos/{id}/renovarVER +
DELETESolicitar eliminación del archivo/archivos/{id}VER +