Desarrolladores · API REST

Automatice la certificación de contenido digital con la API

Captúrelo · Séllelo · Verifíquelo

La API REST de InstantProof le permite certificar cualquier URL pública de forma programática. Autentíquese con una clave de API Bearer, envíe una URL por POST y reciba un certificado PDF firmado con un paquete de prueba completo: el mismo sello de tiempo RFC 3161 y la misma firma Ed25519 que en la interfaz web.

Pruébelo ahora, sin necesidad de cuenta.Su primera prueba es gratuita · 10 € de crédito de bienvenida al confirmar su correo · Sin tarjetaOferta de lanzamiento. El crédito también puede usarse para capturas de páginas web o certificación de archivos.
RESTJSON sobre HTTPS
BearerAutenticación con clave de API
RFC 3161Sellos de tiempo cualificados
Ilustración de la certificación mediante API
  1. 01

    Captúrelo

    Guarde una página web, grabe una sesión de navegador o certifique un archivo.

  2. 02

    Séllelo

    Un sello criptográfico y un sello de tiempo permiten detectar cambios posteriores.

  3. 03

    Verifíquelo

    Cualquiera puede comprobar el paquete de prueba de forma independiente.

Prueba digital. Sencilla.

Capture lo que importa. Antes de que cambie.

Empiece con 10 € de crédito de bienvenida. Conserve un paquete de prueba sellado criptográficamente que puede descargar y verificar.

Capture su primera prueba →

Requisitos previos

1
Plan Pro o superiorLa API requiere la suscripción Pro (funcionalidad api_access). Suscríbase aquí.
2
Una clave de APICréela en Ajustes → Claves de API. Copie la clave en el acto: solo se muestra una vez.
3
Una URL https:// que certificarLa API certifica páginas web accesibles públicamente. La URL debe ser una dirección https:// válida.

Inicio rápido

Tres pasos para pasar de cero a un certificado PDF firmado.

Paso 1: cree una clave de API

Inicie sesión, vaya a Desarrolladores → Claves de API y haga clic en Crear clave de API. Copie la clave: solo se muestra una vez.

Paso 2: cree un certificado

Envíe una solicitud POST con su URL:

curl -X POST https://secure.instantproof.legal/api/v1/certificates \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/page-to-certify"}'

Respuesta 201 Created:

{
  "certificateId": "abc123…",
  "recordingId":   "def456…",
  "url":           "https://example.com/page-to-certify",
  "finalUrl":      "https://example.com/page-to-certify",
  "status":        "ready",
  "links": {
    "self":        "/api/v1/certificates/def456…",
    "certificate": "/api/v1/certificates/def456…/download"
  }
}

Paso 3: descargue el certificado PDF

Siga la URL de links.certificate con su clave de API. El servidor devuelve una redirección 302 a una URL de descarga prefirmada:

curl -L \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  "https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
  -o certificate.pdf

El PDF descargado es el mismo certificado PDF firmado que genera la interfaz web, verificable en /certificate.html.

Referencia de la API

URL base: https://secure.instantproof.legal
Todos los endpoints devuelven JSON. Autenticación: Authorization: Bearer <key>.

POST /api/v1/certificates

Crea un nuevo certificado de sitio web. La plataforma captura la URL en un navegador sin interfaz gráfica, genera un registro de red HAR y una captura de pantalla, firma el manifiesto con Ed25519 y lo ancla a un sello de tiempo cualificado RFC 3161. La operación tarda entre 10 y 60 segundos.

Cuerpo de la solicitud (JSON)

CampoTipoDescripción
urlstringobligatorioUna URL https:// válida que certificar. Debe ser accesible públicamente.

Respuesta 201 Created

CampoTipoDescripción
certificateIdstringIdentificador legible del certificado (el que aparece en el PDF).
recordingIdstringUUID interno de la grabación. Úselo en las llamadas posteriores a la API.
urlstringLa URL que ha enviado.
finalUrlstringLa URL tras cualquier redirección, tal como la vio el navegador.
statusstring"ready": el certificado está disponible de inmediato.
links.selfstringRuta para obtener los metadatos de este certificado.
links.certificatestringRuta para descargar el PDF. Requiere autenticación.

Respuestas de error

EstadoerrorSignificado
400invalid_urlFalta el campo url o no es una dirección https:// válida.
400invalid_jsonEl cuerpo de la solicitud no es un JSON válido.
401invalid_api_keyFalta la cabecera Authorization o no es válida.
402api_access_requiredSu cuenta no tiene el plan Pro. Suscríbase.
403subscription_requiredLos certificados web requieren una suscripción de tarifa plana.
403insufficient_scopeLa clave de API no tiene el ámbito certificates:write.
413payload_too_largeEl cuerpo de la solicitud supera los 64 KB.
429quota_exceededSe ha alcanzado la cuota diaria de capturas por API. Se restablece cada día.
429rate_limitedDemasiadas solicitudes. Consulte la cabecera Retry-After.
429service_busyEl servicio de captura está al límite de su capacidad. Vuelva a intentarlo en unos 30 segundos.
502capture_failedEl navegador no ha podido cargar la URL.
502certification_failedLa captura no ha producido pruebas utilizables (p. ej., un HAR vacío).

GET /api/v1/certificates/:recordingId

Obtiene los metadatos de un certificado que haya creado anteriormente.

Parámetros de ruta

ParámetroDescripción
recordingIdobligatorioEl recordingId devuelto por POST /api/v1/certificates.

Respuesta 200 OK

CampoTipoDescripción
certificateIdstringIdentificador legible del certificado.
recordingIdstringUUID interno de la grabación.
typestringTipo de grabación (p. ej., "webcapture").
statusstring"ready" cuando el certificado está disponible.
urlstringLa URL que se ha certificado.
createdAtstringFecha y hora de creación en formato ISO 8601.
linksobjectRutas self y certificate.

GET /api/v1/certificates/:recordingId/download

Descarga el certificado PDF firmado. Devuelve 302 Found: siga la redirección para recibir el archivo. Use curl -L o requests.get(..., allow_redirects=True).

Autenticación

Todas las solicitudes a la API deben incluir:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Las claves se crean en Ajustes → Desarrolladores → Claves de API. Una clave le autentica como titular de su cuenta: trátela como una contraseña. Revóquela de inmediato si se filtra.

Las claves de las cuentas reales llevan el prefijo ip_live_. El prefijo le ayuda a identificarlas en el código o en los archivos de entorno.

Límites de frecuencia y cuotas

~30

Solicitudes por minuto

30 solicitudes/minuto de forma sostenida (ráfaga: 30). Si se superan, se devuelve 429 rate_limited con una cabecera Retry-After.

Diaria

Cuota diaria de capturas

El plan Pro concede un número fijo de certificados al día. La cuota se restablece cada día. Si se supera, se devuelve 429 quota_exceeded.

64 KB

Límite del cuerpo de la solicitud

El cuerpo JSON de la solicitud no debe superar los 64 KB. En la práctica, una URL queda muy por debajo de este límite.

Ejemplos de código

Python

import requests

API_KEY = "ip_live_xxxxxxxxxxxxxxxx"
BASE    = "https://secure.instantproof.legal"

# Crear un certificado
resp = requests.post(
    f"{BASE}/api/v1/certificates",
    json={"url": "https://example.com"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
resp.raise_for_status()
data = resp.json()
recording_id = data["recordingId"]

# Descargar el PDF
pdf = requests.get(
    f"{BASE}/api/v1/certificates/{recording_id}/download",
    headers={"Authorization": f"Bearer {API_KEY}"},
    allow_redirects=True,
)
pdf.raise_for_status()
with open("certificate.pdf", "wb") as f:
    f.write(pdf.content)
print(f"Certificado guardado ({len(pdf.content)} bytes)")

Node.js (fetch)

const API_KEY = process.env.INSTANTPROOF_API_KEY;
const BASE    = "https://secure.instantproof.legal";

// Crear un certificado
const res = await fetch(`${BASE}/api/v1/certificates`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com" }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { recordingId, links } = await res.json();

// Descargar el PDF
const pdf = await fetch(`${BASE}${links.certificate}`, {
  headers: { "Authorization": `Bearer ${API_KEY}` },
  redirect: "follow",
});
const buffer = Buffer.from(await pdf.arrayBuffer());
require("fs").writeFileSync("certificate.pdf", buffer);

Shell (curl)

# Defina su clave
export INSTANTPROOF_API_KEY="ip_live_xxxxxxxxxxxxxxxx"

# Crear
CERT=$(curl -sf -X POST https://secure.instantproof.legal/api/v1/certificates \
  -H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}')

echo "$CERT" | python3 -m json.tool

RECORDING_ID=$(echo "$CERT" | python3 -c "import sys,json; print(json.load(sys.stdin)['recordingId'])")

# Descargar
curl -sfL \
  -H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
  "https://secure.instantproof.legal/api/v1/certificates/$RECORDING_ID/download" \
  -o certificate.pdf

ls -lh certificate.pdf

Preguntas frecuentes

¿Cuánto tarda la creación de un certificado?

Normalmente entre 10 y 60 segundos, según el tiempo de carga de la página de destino. La solicitud POST espera hasta que el certificado está listo: no hay que consultar el estado periódicamente.

¿Admite la API certificados de archivo (PDF, imágenes subidas)?

La API actual solo admite la certificación de sitios web (URL). La subida de archivos está disponible a través de la interfaz web en secure.instantproof.legal/certificates/new.

¿Puedo verificar un certificado creado a través de la API?

Sí. El PDF que genera la API es idéntico al que se crea desde la interfaz web. Arrástrelo a instantproof.legal/certificate.html para verificar la firma Ed25519 y la cadena del sello de tiempo RFC 3161.

¿Qué ocurre si no se puede acceder a la URL?

El servicio de captura devuelve un error 502 capture_failed. No se consume su cuota diaria.

¿Aparecen en el panel web los certificados creados con la API?

Sí. Todos los certificados creados a través de la API aparecen en su panel de Certificados, en Mis certificados de sitio web, junto a los certificados creados desde la interfaz web.