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.
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étodo | Descripción | Recurso | Guía |
|---|---|---|---|
POST | Crear un nuevo archivo | /archivos | VER + |
PUT | Agregar contenido binario | /archivos/{id}/binario | VER + |
PUT | Finalizar la carga del archivo | /archivos/{id}/finalizar | VER + |
GET | Consultar detalles del archivo | /archivos/{id} | VER + |
GET | Descargar el binario del archivo | /archivos/{id}/binario | VER + |
PUT | Renovar la vigencia del archivo | /archivos/{id}/renovar | VER + |
DELETE | Solicitar eliminación del archivo | /archivos/{id} | VER + |