Documentación API

Integrá Archivalo con tu sistema.

Emití constancias desde tu portal, ERP o flujo documental usando una API REST con autenticación por clave. La respuesta es la misma constancia que se verifica públicamente: token, hash, fecha y URL de verificación.

Empezar ahora Ver guía de servicios

Cómo integrar

Tres pasos para emitir tu primera constancia por API.

Las claves API se crean desde el panel; los endpoints devuelven el mismo JSON firmable que el verificador público. No hay SDK propio: cualquier cliente HTTP sirve.

01
Creá una clave API
Desde tu panel de Archivalo: Configuración → Claves API. Asigná un nombre legible y un alcance (lectura, escritura o ambos).
obtenés → ak_live_… (32 caracteres)
02
Llamá al endpoint de emisión
POST /v1/certificates con el tipo de evidencia y los metadatos mínimos. Recibís un token y la URL pública de verificación.
obtenés → token + verification_url
03
Compartí o verificá
Compartí la URL de verificación con quien tenga que revisar la constancia, o llamá a GET /v1/verificar/{token} desde tu sistema.
obtenés → JSON firmable y reproducible

Endpoints

Cuatro endpoints cubren el ciclo de vida.

Emití, listá, verificá y adjuntá el archivo original. Los métodos son REST estándar y las respuestas son JSON sin envoltorios adicionales.

Catálogo de servicios Verificar una constancia

https://api.archivalo.com.py

REST + JSON

POST
/v1/certificates
Emitir una constancia (archivo, página, PDF, video o correo).
Auth: API key con scope escritura
GET
/v1/verificar/{token}
Consultar una constancia por su token público.
Auth: API key con scope lectura (o público, si el token existe)
GET
/v1/certificados
Listar constancias emitidas por el equipo.
Auth: API key con scope lectura
POST
/v1/certificados/{id}/boveda
Adjuntar el archivo original a la constancia para verificación directa.
Auth: API key con scope escritura

Ejemplos

Pegá, ejecutá, verificá.

Las respuestas son las mismas que las del verificador público. Pegá elverification_urlen un navegador para abrir la página de verificación.

POST/v1/certificates

Emisión

curl -X POST https://api.archivalo.com.py/v1/certificates \
  -H "Authorization: Bearer ak_live_…TU_API_KEY…" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "archivo",
    "subject": "contrato-2026-q2.pdf",
    "metadata": { "teamId": 42 }
  }'

200 OKapplication/json

Respuesta

{
  "id": "8a3e-7c1d-4f02-9b18",
  "type": "constancia",
  "subject": "contrato-2026-q2.pdf",
  "issued_at": "2026-06-05T10:31:08-03:00",
  "hash": "sha256:7c1d8a3e4f029b18…",
  "status": "verified",
  "verification_url": "https://www.archivalo.com.py/verificar/8a3e-7c1d-4f02-9b18"
}

GET/v1/verificar/<token>

Verificación

curl https://api.archivalo.com.py/v1/verificar/8a3e-7c1d-4f02-9b18

Qué hace la API

Emite constancias con hash, timestamp, firma y, cuando aplica, registro externo.
Lista y consulta constancias previas por token o por equipo.
Devuelve la URL pública de verificación lista para compartir.
Permite rotar y revocar claves API sin afectar a constancias emitidas.

Qué no hace

La API no acredita autoría, titularidad, licitud del contenido ni aceptación judicial automática. La valoración probatoria depende del contexto, de la autoridad competente y de la normativa aplicable.

Para el alcance completo, leé la página de confianza antes de integrar constancias en un flujo legal o regulado.

Ver alcance y confianza →Términos y condiciones →

Empezá por crear una clave API en tu panel.

Si todavía no tenés cuenta, el alta es por OAuth y podés emitir la primera constancia en pocos minutos.

Crear clave API Ver planes