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.
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.
Salvați o pagină web, înregistrați o sesiune de browser sau certificați un fișier.
Un sigiliu criptografic și o marcă temporală ajută la dezvăluirea modificărilor ulterioare.
Oricine poate verifica pachetul de probe în mod independent.
Î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.
Trei pași de la zero la un certificat PDF semnat.
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ă.
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"
}
}
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.
URL de bază: https://secure.instantproof.legal
Toate endpoint-urile returnează JSON. Autentificare: Authorization: Bearer <key>.
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.
| Câmp | Tip | Descriere | |
|---|---|---|---|
url | string | obligatoriu | Un URL https:// valid de certificat. Trebuie să fie accesibil public. |
| Câmp | Tip | Descriere |
|---|---|---|
certificateId | string | ID-ul certificatului, lizibil pentru om (afișat pe PDF). |
recordingId | string | UUID intern al înregistrării. Folosiți-l în apelurile API ulterioare. |
url | string | URL-ul pe care l-ați transmis. |
finalUrl | string | URL-ul după eventualele redirecționări, așa cum l-a văzut browserul. |
status | string | "ready" — certificatul este disponibil imediat. |
links.self | string | Calea pentru obținerea metadatelor acestui certificat. |
links.certificate | string | Calea pentru descărcarea PDF-ului. Necesită autentificare. |
| Stare | eroare | Semnificație |
|---|---|---|
| 400 | invalid_url | Câmpul url lipsește sau nu este o adresă https:// validă. |
| 400 | invalid_json | Corpul cererii nu este JSON valid. |
| 401 | invalid_api_key | Antetul Authorization lipsește sau este invalid. |
| 402 | api_access_required | Contul dumneavoastră nu are planul Pro. Abonați-vă. |
| 403 | subscription_required | Certificatele web necesită un abonament cu tarif fix. |
| 403 | insufficient_scope | Cheia API nu are permisiunea certificates:write. |
| 413 | payload_too_large | Corpul cererii depășește 64 KB. |
| 429 | quota_exceeded | S-a atins cota zilnică de capturi API. Se resetează în fiecare zi. |
| 429 | rate_limited | Prea multe cereri. Consultați antetul Retry-After. |
| 429 | service_busy | Serviciul de captură este la capacitate maximă. Reîncercați după aproximativ 30 de secunde. |
| 502 | capture_failed | Browserul nu a putut încărca URL-ul. |
| 502 | certification_failed | Captura nu a produs probe utilizabile (de ex. HAR gol). |
Obține metadatele unui certificat creat anterior de dumneavoastră.
| Parametru | Descriere | |
|---|---|---|
recordingId | obligatoriu | recordingId returnat de POST /api/v1/certificates. |
| Câmp | Tip | Descriere |
|---|---|---|
certificateId | string | ID-ul certificatului, lizibil pentru om. |
recordingId | string | UUID intern al înregistrării. |
type | string | Tipul înregistrării (de ex. "webcapture"). |
status | string | "ready" după ce certificatul este disponibil. |
url | string | URL-ul care a fost certificat. |
createdAt | string | Marca temporală a creării, în format ISO 8601. |
links | object | Căile self și certificate. |
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).
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.
30 de cereri/minut în regim susținut (rafală: 30). La depășire se returnează 429 rate_limited cu antetul Retry-After.
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.
Corpul cererii JSON nu trebuie să depășească 64 KB. În practică, un URL se află cu mult sub această limită.
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)")
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);
# 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
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 actual acceptă doar certificarea site-urilor web (URL). Încărcarea fișierelor este disponibilă prin interfața web, la secure.instantproof.legal/certificates/new.
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.
Serviciul de captură returnează eroarea 502 capture_failed. Cota dumneavoastră zilnică nu se consumă.
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.