Dezvoltatori · API REST

Automatizați certificarea conținutului digital prin API

Capturați · Sigilați · Verificați

API-ul REST InstantProof vă permite să certificați programatic orice URL public. Autentificați-vă cu o cheie API de tip Bearer, trimiteți prin POST un URL și primiți un certificat PDF semnat, cu un pachet complet de probe — aceeași marcă temporală RFC 3161 și aceeași semnătură Ed25519 ca în interfața web.

Încercați acum, fără cont.Prima dumneavoastră dovadă este gratuită · credit de bun venit de 10 € la confirmarea e-mailului · Fără cardOfertă de lansare. Creditul poate fi folosit și pentru capturi de pagini web sau certificarea fișierelor.
RESTJSON prin HTTPS
BearerAutentificare cu cheie API
RFC 3161Mărci temporale calificate
Ilustrație a certificării prin API
  1. 01

    Capturați

    Salvați o pagină web, înregistrați o sesiune de browser sau certificați un fișier.

  2. 02

    Sigilați

    Un sigiliu criptografic și o marcă temporală ajută la dezvăluirea modificărilor ulterioare.

  3. 03

    Verificați

    Oricine poate verifica pachetul de probe în mod independent.

Probe digitale. Simplu.

Capturați ce contează. Înainte să se schimbe.

Începeți cu un credit de bun venit de 10 €. Păstrați un pachet de probe sigilat criptografic, pe care îl puteți descărca și verifica.

Capturați prima dumneavoastră dovadă →

Cerințe preliminare

1
Plan Pro sau superiorAPI-ul necesită abonamentul Pro (funcția api_access). Abonați-vă aici.
2
O cheie APICreați una la Setări → Chei API. Copiați cheia imediat — este afișată o singură dată.
3
Un URL https:// de certificatAPI-ul certifică pagini web accesibile public. URL-ul trebuie să fie o adresă https:// validă.

Început rapid

Trei pași de la zero la un certificat PDF semnat.

Pasul 1 — Creați o cheie API

Autentificați-vă, mergeți la Dezvoltatori → Chei API și faceți clic pe Creează cheie API. Copiați cheia — este afișată o singură dată.

Pasul 2 — Creați un certificat

Trimiteți o cerere POST cu URL-ul dumneavoastră:

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"}'

Răspuns 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"
  }
}

Pasul 3 — Descărcați certificatul PDF

Accesați URL-ul links.certificate cu cheia dumneavoastră API. Serverul returnează o redirecționare 302 către un URL de descărcare presemnat:

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

PDF-ul descărcat este același certificat PDF semnat pe care îl produce interfața web, verificabil la /certificate.html.

Referință API

URL de bază: https://secure.instantproof.legal
Toate endpoint-urile returnează JSON. Autentificare: Authorization: Bearer <key>.

POST /api/v1/certificates

Creează un nou certificat pentru site web. Platforma capturează URL-ul într-un browser fără interfață grafică, produce un jurnal de rețea HAR și o captură de ecran, semnează manifestul cu Ed25519 și îl ancorează la o marcă temporală electronică calificată RFC 3161. Operațiunea durează 10–60 de secunde.

Corpul cererii (JSON)

CâmpTipDescriere
urlstringobligatoriuUn URL https:// valid de certificat. Trebuie să fie accesibil public.

Răspuns 201 Created

CâmpTipDescriere
certificateIdstringID-ul certificatului, lizibil pentru om (afișat pe PDF).
recordingIdstringUUID intern al înregistrării. Folosiți-l în apelurile API ulterioare.
urlstringURL-ul pe care l-ați transmis.
finalUrlstringURL-ul după eventualele redirecționări, așa cum l-a văzut browserul.
statusstring"ready" — certificatul este disponibil imediat.
links.selfstringCalea pentru obținerea metadatelor acestui certificat.
links.certificatestringCalea pentru descărcarea PDF-ului. Necesită autentificare.

Răspunsuri de eroare

StareeroareSemnificație
400invalid_urlCâmpul url lipsește sau nu este o adresă https:// validă.
400invalid_jsonCorpul cererii nu este JSON valid.
401invalid_api_keyAntetul Authorization lipsește sau este invalid.
402api_access_requiredContul dumneavoastră nu are planul Pro. Abonați-vă.
403subscription_requiredCertificatele web necesită un abonament cu tarif fix.
403insufficient_scopeCheia API nu are permisiunea certificates:write.
413payload_too_largeCorpul cererii depășește 64 KB.
429quota_exceededS-a atins cota zilnică de capturi API. Se resetează în fiecare zi.
429rate_limitedPrea multe cereri. Consultați antetul Retry-After.
429service_busyServiciul de captură este la capacitate maximă. Reîncercați după aproximativ 30 de secunde.
502capture_failedBrowserul nu a putut încărca URL-ul.
502certification_failedCaptura nu a produs probe utilizabile (de ex. HAR gol).

GET /api/v1/certificates/:recordingId

Obține metadatele unui certificat creat anterior de dumneavoastră.

Parametrii căii

ParametruDescriere
recordingIdobligatoriurecordingId returnat de POST /api/v1/certificates.

Răspuns 200 OK

CâmpTipDescriere
certificateIdstringID-ul certificatului, lizibil pentru om.
recordingIdstringUUID intern al înregistrării.
typestringTipul înregistrării (de ex. "webcapture").
statusstring"ready" după ce certificatul este disponibil.
urlstringURL-ul care a fost certificat.
createdAtstringMarca temporală a creării, în format ISO 8601.
linksobjectCăile self și certificate.

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

Descarcă certificatul PDF semnat. Returnează 302 Found — urmați redirecționarea pentru a primi fișierul. Folosiți curl -L sau requests.get(..., allow_redirects=True).

Autentificare

Toate cererile API trebuie să includă:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Cheile se creează la Setări → Dezvoltatori → Chei API. O cheie vă autentifică drept titular al contului — tratați-o ca pe o parolă. Revocați-o imediat dacă a fost divulgată.

Cheile au prefixul ip_live_ pentru conturile live. Prefixul vă ajută să le identificați în cod sau în fișiere de mediu.

Limite de frecvență & cote

~30

Cereri pe minut

30 de cereri/minut în regim susținut (rafală: 30). La depășire se returnează 429 rate_limited cu antetul Retry-After.

Zilnic

Cota zilnică de capturi

Planul Pro oferă un număr fix de certificate create pe zi. Cota se resetează în fiecare zi. La depășire se returnează 429 quota_exceeded.

64 KB

Limita corpului cererii

Corpul cererii JSON nu trebuie să depășească 64 KB. În practică, un URL se află cu mult sub această limită.

Exemple de cod

Python

import requests

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

# Create a certificate
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"]

# Download the 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"Certificate saved ({len(pdf.content)} bytes)")

Node.js (fetch)

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

// Create a certificate
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();

// Download the 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)

# Set your key
export INSTANTPROOF_API_KEY="ip_live_xxxxxxxxxxxxxxxx"

# Create
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'])")

# Download
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

Întrebări frecvente

Cât durează crearea unui certificat?

De regulă 10–60 de secunde, în funcție de timpul de încărcare al paginii vizate. Cererea POST rămâne deschisă până când certificatul este gata — nu există un pas de interogare repetată.

API-ul acceptă certificate pentru fișiere (PDF, încărcări de imagini)?

API-ul actual acceptă doar certificarea site-urilor web (URL). Încărcarea fișierelor este disponibilă prin interfața web, la secure.instantproof.legal/certificates/new.

Pot verifica un certificat creat prin API?

Da. PDF-ul produs de API este identic cu cel creat prin interfața web. Trageți-l pe instantproof.legal/certificate.html pentru a verifica semnătura Ed25519 și lanțul mărcii temporale RFC 3161.

Ce se întâmplă dacă URL-ul nu poate fi accesat?

Serviciul de captură returnează eroarea 502 capture_failed. Cota dumneavoastră zilnică nu se consumă.

Certificatele create prin API sunt vizibile în panoul web?

Da. Fiecare certificat creat prin API apare în panoul Certificate, la Certificatele mele pentru site-uri web, alături de certificatele create prin interfața web.