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.
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.
Guarde una página web, grabe una sesión de navegador o certifique un archivo.
Un sello criptográfico y un sello de tiempo permiten detectar cambios posteriores.
Cualquiera puede comprobar el paquete de prueba de forma independiente.
Empiece con 10 € de crédito de bienvenida. Conserve un paquete de prueba sellado criptográficamente que puede descargar y verificar.
Tres pasos para pasar de cero a un certificado PDF firmado.
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.
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"
}
}
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.
URL base: https://secure.instantproof.legal
Todos los endpoints devuelven JSON. Autenticación: Authorization: Bearer <key>.
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.
| Campo | Tipo | Descripción | |
|---|---|---|---|
url | string | obligatorio | Una URL https:// válida que certificar. Debe ser accesible públicamente. |
| Campo | Tipo | Descripción |
|---|---|---|
certificateId | string | Identificador legible del certificado (el que aparece en el PDF). |
recordingId | string | UUID interno de la grabación. Úselo en las llamadas posteriores a la API. |
url | string | La URL que ha enviado. |
finalUrl | string | La URL tras cualquier redirección, tal como la vio el navegador. |
status | string | "ready": el certificado está disponible de inmediato. |
links.self | string | Ruta para obtener los metadatos de este certificado. |
links.certificate | string | Ruta para descargar el PDF. Requiere autenticación. |
| Estado | error | Significado |
|---|---|---|
| 400 | invalid_url | Falta el campo url o no es una dirección https:// válida. |
| 400 | invalid_json | El cuerpo de la solicitud no es un JSON válido. |
| 401 | invalid_api_key | Falta la cabecera Authorization o no es válida. |
| 402 | api_access_required | Su cuenta no tiene el plan Pro. Suscríbase. |
| 403 | subscription_required | Los certificados web requieren una suscripción de tarifa plana. |
| 403 | insufficient_scope | La clave de API no tiene el ámbito certificates:write. |
| 413 | payload_too_large | El cuerpo de la solicitud supera los 64 KB. |
| 429 | quota_exceeded | Se ha alcanzado la cuota diaria de capturas por API. Se restablece cada día. |
| 429 | rate_limited | Demasiadas solicitudes. Consulte la cabecera Retry-After. |
| 429 | service_busy | El servicio de captura está al límite de su capacidad. Vuelva a intentarlo en unos 30 segundos. |
| 502 | capture_failed | El navegador no ha podido cargar la URL. |
| 502 | certification_failed | La captura no ha producido pruebas utilizables (p. ej., un HAR vacío). |
Obtiene los metadatos de un certificado que haya creado anteriormente.
| Parámetro | Descripción | |
|---|---|---|
recordingId | obligatorio | El recordingId devuelto por POST /api/v1/certificates. |
| Campo | Tipo | Descripción |
|---|---|---|
certificateId | string | Identificador legible del certificado. |
recordingId | string | UUID interno de la grabación. |
type | string | Tipo de grabación (p. ej., "webcapture"). |
status | string | "ready" cuando el certificado está disponible. |
url | string | La URL que se ha certificado. |
createdAt | string | Fecha y hora de creación en formato ISO 8601. |
links | object | Rutas self y certificate. |
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).
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.
30 solicitudes/minuto de forma sostenida (ráfaga: 30). Si se superan, se devuelve 429 rate_limited con una cabecera Retry-After.
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.
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.
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)")
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);
# 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
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.
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.
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.
El servicio de captura devuelve un error 502 capture_failed. No se consume su cuota diaria.
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.