Saltar al contenido
Archivalo

Documentación

Guía de servicios

Referencia rápida: qué hace cada servicio, cuándo usarlo, qué garantiza y qué no.

Integración API

Disponible

Si tenés un sistema propio, la API te permitirá automatizar la emisión de certificados/evidencias sin depender del panel.

  • Automatización y volumen: certificación a demanda desde tu backend.
  • Integración en flujos existentes (compliance, atención al cliente, operaciones).
  • Resultados verificables y auditables con claves vinculadas a un equipo.

¿Qué es?

Permite integrar Archivalo con tus sistemas para emitir certificados de existencia de archivo desde un hash SHA-256 o desde un archivo enviado por multipart.

En 3 pasos

  1. 1Creás una clave API para el equipo comprador.
  2. 2Llamás el endpoint de hash o archivo desde tu backend; el equipo se toma de la clave, no del request.
  3. 3Recibís hashes, token público, teamId y URL de verificación.

Qué obtenés

  • Endpoints para emisión por hash y archivo
  • Respuesta JSON con certificado, hashes y verificación pública

Cuándo usarlo

Integraciones internas (automatizar certificación desde tu backend)Productos con evidencia embebida (prueba como feature)Automatización de compliance (evidencia por evento)Ecommerce (cambios de precio/condiciones certificados automáticamente)Soporte/CRM (certificar estados y adjuntos en tickets)Finanzas (resguardar documentos generados por el sistema)Operaciones (certificar outputs de procesos críticos)Auditoría y reportes (evidencia verificable por request)

Contrato inicial de integración

Las claves se crean por equipo desde el panel con alcance certificates:write. Cada emisión consume el plan del equipo dueño de la clave.

Autenticación

Enviá la clave con X-API-Key: akarchivalo_... o Authorization: ApiKey akarchivalo_....

El secreto se muestra una sola vez al crearlo; si se pierde, revocá la clave y generá otra.

Equipo y permisos

La clave pertenece al equipo y todas sus emisiones consumen el plan de ese equipo.

No envíes teamId en el request de emisión.

Owners y admins del equipo pueden crear, listar y revocar claves.

Límites

60 certificados por minuto por clave inicialmente.

Carga de archivos hasta 100 MB.

Si el equipo no tiene espacio de Bóveda, la API rechaza antes de guardar.

Endpoints

POST/api/archivalo/integrations/certificates/hash
curl -X POST https://www.archivalo.com.py/api/archivalo/integrations/certificates/hash \
  -H "X-API-Key: akarchivalo_..." \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "contrato.pdf",
    "fileSize": 238120,
    "fileHash": "64_hex_sha256"
  }'
POST/api/archivalo/integrations/certificates/file
curl -X POST https://www.archivalo.com.py/api/archivalo/integrations/certificates/file \
  -H "X-API-Key: akarchivalo_..." \
  -F "[email protected]" \
  -F "expectedFileHash=64_hex_sha256" \
  -F "preserveOriginal=true"

Respuesta exitosa

{
  "certificateId": "A01:...",
  "certificateDatabaseId": 456,
  "teamId": 123,
  "vaultFileId": 789,
  "originalStored": true,
  "vaultLinked": true,
  "fileName": "contrato.pdf",
  "fileSize": 238120,
  "fileHash": "64_hex_sha256",
  "certificateHash": "64_hex_sha256",
  "auditTrailHash": "64_hex_sha256",
  "proofBundleHash": "64_hex_sha256",
  "publicVerificationToken": "...",
  "publicVerificationUrl": "https://www.archivalo.com.py/verificar/...",
  "certificatePdfUrl": "https://www.archivalo.com.py/api/archivalo/certificados/verificacion/.../pdf"
}

Headers de rate limit

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y Retry-After.

Códigos de error

400 hash inválido, 401 clave inválida, 402 cupo agotado, 429 demasiadas emisiones.

Servicios relacionados