Užklausos per minutę
30 užklausų per minutę nuolat (šuoliu: 30). Viršijus grąžinama 429 rate_limited su antrašte Retry-After.
„InstantProof“ REST API leidžia programiškai sertifikuoti bet kurį viešą URL. Autentifikuokitės Bearer API raktu, išsiųskite URL POST užklausa ir gaukite pasirašytą sertifikato PDF su visu įrodymų paketu – su ta pačia RFC 3161 laiko žyma ir Ed25519 parašu kaip ir žiniatinklio sąsajoje.
Išsaugokite tinklalapį, įrašykite naršyklės sesiją arba sertifikuokite failą.
Kriptografinis antspaudas ir laiko žymos padeda atskleisti vėlesnius pakeitimus.
Bet kas gali nepriklausomai patikrinti įrodymų paketą.
Pradėkite su 10 € pasveikinimo kreditu. Pasilikite kriptografiškai užantspauduotą įrodymų paketą, kurį galite atsisiųsti ir patikrinti.
Trys žingsniai nuo nulio iki pasirašyto sertifikato PDF.
Prisijunkite, eikite į Kūrėjams → API raktai ir spustelėkite Sukurti API raktą. Raktą nukopijuokite – jis rodomas tik vieną kartą.
Išsiųskite POST užklausą su savo 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"}'
Atsakymas 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"
}
}
Atidarykite links.certificate URL su savo API raktu. Serveris grąžina 302 peradresavimą į iš anksto pasirašytą atsisiuntimo URL:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Atsisiųstas PDF yra tas pats pasirašytas sertifikato PDF, kurį sukuria žiniatinklio sąsaja; jį galima patikrinti adresu /certificate.html.
Bazinis URL: https://secure.instantproof.legal
Visi galiniai taškai grąžina JSON. Autentifikavimas: Authorization: Bearer <key>.
Sukuria naują svetainės sertifikatą. Platforma užfiksuoja URL be grafinės sąsajos naršyklėje, sukuria HAR tinklo žurnalą ir ekrano nuotrauką, pasirašo manifestą Ed25519 ir pririša prie kvalifikuotos RFC 3161 laiko žymos. Operacija trunka 10–60 sekundžių.
| Laukas | Tipas | Aprašymas | |
|---|---|---|---|
url | string | privalomas | Galiojantis https:// URL, kurį norite sertifikuoti. Turi būti viešai pasiekiamas. |
| Laukas | Tipas | Aprašymas |
|---|---|---|
certificateId | string | Žmogui suprantamas sertifikato ID (rodomas PDF). |
recordingId | string | Vidinis įrašo UUID. Naudokite tolesnėse API užklausose. |
url | string | Jūsų pateiktas URL. |
finalUrl | string | URL po visų peradresavimų, kaip jį matė naršyklė. |
status | string | "ready" – sertifikatas iškart pasiekiamas. |
links.self | string | Kelias šio sertifikato metaduomenims gauti. |
links.certificate | string | Kelias PDF atsisiųsti. Reikalingas autentifikavimas. |
| Būsena | klaida | Reikšmė |
|---|---|---|
| 400 | invalid_url | Laukas url nenurodytas arba nėra galiojantis https:// adresas. |
| 400 | invalid_json | Užklausos turinys nėra galiojantis JSON. |
| 401 | invalid_api_key | Trūksta antraštės Authorization arba ji negalioja. |
| 402 | api_access_required | Jūsų paskyra neturi Pro plano. Prenumeruokite. |
| 403 | subscription_required | Žiniatinklio sertifikatams reikalinga fiksuoto mokesčio prenumerata. |
| 403 | insufficient_scope | API raktas neturi certificates:write srities. |
| 413 | payload_too_large | Užklausos turinys viršija 64 KB. |
| 429 | quota_exceeded | Pasiekta dienos API užfiksavimų kvota. Atsinaujina kiekvieną dieną. |
| 429 | rate_limited | Per daug užklausų. Žr. antraštę Retry-After. |
| 429 | service_busy | Užfiksavimo paslauga viršijo pajėgumą. Bandykite dar kartą po ~30 sekundžių. |
| 502 | capture_failed | Naršyklė negalėjo įkelti URL. |
| 502 | certification_failed | Užfiksavus negauta tinkamų įrodymų (pvz., tuščias HAR). |
Gauna anksčiau sukurto sertifikato metaduomenis.
| Parametras | Aprašymas | |
|---|---|---|
recordingId | privalomas | recordingId, grąžintas POST /api/v1/certificates užklausos. |
| Laukas | Tipas | Aprašymas |
|---|---|---|
certificateId | string | Žmogui suprantamas sertifikato ID. |
recordingId | string | Vidinis įrašo UUID. |
type | string | Įrašo tipas (pvz., "webcapture"). |
status | string | "ready", kai sertifikatas pasiekiamas. |
url | string | Sertifikuotas URL. |
createdAt | string | ISO 8601 sukūrimo laiko žyma. |
links | object | keliai self ir certificate. |
Atsisiunčia pasirašytą sertifikato PDF. Grąžina 302 Found – sekite peradresavimą, kad gautumėte failą. Naudokite curl -L arba requests.get(..., allow_redirects=True).
Visose API užklausose turi būti:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Raktai kuriami skiltyje Nustatymai → Kūrėjams → API raktai. Raktas autentifikuoja kaip Jūsų paskyra – elkitės su juo kaip su slaptažodžiu. Jei jis nutekėjo, nedelsdami jį atšaukite.
Aktyvių paskyrų raktai prasideda priešdėliu ip_live_. Priešdėlis padeda juos atpažinti kode ar aplinkos failuose.
30 užklausų per minutę nuolat (šuoliu: 30). Viršijus grąžinama 429 rate_limited su antrašte Retry-After.
Pro planas suteikia fiksuotą sertifikatų kūrimų skaičių per dieną. Kvota atsinaujina kiekvieną dieną. Ją viršijus grąžinama 429 quota_exceeded.
JSON užklausos turinys negali viršyti 64 KB. Praktiškai URL yra gerokai mažesnis už šią ribą.
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
Paprastai 10–60 sekundžių, priklausomai nuo tikslinio puslapio įkėlimo laiko. POST užklausa blokuojama, kol sertifikatas bus paruoštas – papildomo būsenos tikrinimo žingsnio nėra.
Dabartinė API palaiko tik svetainių (URL) sertifikavimą. Failų įkėlimas galimas per žiniatinklio sąsają adresu secure.instantproof.legal/certificates/new.
Taip. API sukurtas PDF yra identiškas sukurtam per žiniatinklio sąsają. Nuvilkite jį ant instantproof.legal/certificate.html, kad patikrintumėte Ed25519 parašą ir RFC 3161 laiko žymos grandinę.
Užfiksavimo paslauga grąžina 502 capture_failed klaidą. Jūsų dienos kvota neišnaudojama.
Taip. Kiekvienas per API sukurtas sertifikatas rodomas Jūsų Sertifikatų skydelyje skiltyje Mano svetainių sertifikatai kartu su sertifikatais, sukurtais per žiniatinklio sąsają.