Kūrėjams · REST API

Automatizuokite skaitmeninio turinio sertifikavimą per API

Užfiksuokite · Užantspauduokite · Patikrinkite

„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šbandykite dabar, paskyros nereikia.Pirmasis įrodymas nemokamas · 10 € pasveikinimo kreditas patvirtinus el. paštą · Kortelės nereikiaPradžios pasiūlymas. Kreditą galima naudoti ir tinklalapių fiksavimui, ir failų sertifikavimui.
RESTJSON per HTTPS
BearerAutentifikavimas API raktu
RFC 3161Kvalifikuotos laiko žymos
API sertifikavimo iliustracija
  1. 01

    Užfiksuokite

    Išsaugokite tinklalapį, įrašykite naršyklės sesiją arba sertifikuokite failą.

  2. 02

    Užantspauduokite

    Kriptografinis antspaudas ir laiko žymos padeda atskleisti vėlesnius pakeitimus.

  3. 03

    Patikrinkite

    Bet kas gali nepriklausomai patikrinti įrodymų paketą.

Skaitmeniniai įrodymai. Paprastai.

Užfiksuokite tai, kas svarbu. Kol tai nepasikeitė.

Pradėkite su 10 € pasveikinimo kreditu. Pasilikite kriptografiškai užantspauduotą įrodymų paketą, kurį galite atsisiųsti ir patikrinti.

Užfiksuokite pirmąjį įrodymą →

Išankstinės sąlygos

1
Pro ar aukštesnis planasAPI reikalauja Pro prenumeratos (api_access funkcija). Prenumeruokite čia.
2
API raktasSukurkite jį skiltyje Nustatymai → API raktai. Raktą nukopijuokite iškart – jis rodomas tik vieną kartą.
3
https:// URL, kurį norite sertifikuotiAPI sertifikuoja viešai pasiekiamus tinklalapius. URL turi būti galiojantis https:// adresas.

Greita pradžia

Trys žingsniai nuo nulio iki pasirašyto sertifikato PDF.

1 žingsnis – sukurkite API raktą

Prisijunkite, eikite į Kūrėjams → API raktai ir spustelėkite Sukurti API raktą. Raktą nukopijuokite – jis rodomas tik vieną kartą.

2 žingsnis – sukurkite sertifikatą

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

3 žingsnis – atsisiųskite sertifikato PDF

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.

API žinynas

Bazinis URL: https://secure.instantproof.legal
Visi galiniai taškai grąžina JSON. Autentifikavimas: Authorization: Bearer <key>.

POST /api/v1/certificates

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ų.

Užklausos turinys (JSON)

LaukasTipasAprašymas
urlstringprivalomasGaliojantis https:// URL, kurį norite sertifikuoti. Turi būti viešai pasiekiamas.

Atsakymas 201 Created

LaukasTipasAprašymas
certificateIdstringŽmogui suprantamas sertifikato ID (rodomas PDF).
recordingIdstringVidinis įrašo UUID. Naudokite tolesnėse API užklausose.
urlstringJūsų pateiktas URL.
finalUrlstringURL po visų peradresavimų, kaip jį matė naršyklė.
statusstring"ready" – sertifikatas iškart pasiekiamas.
links.selfstringKelias šio sertifikato metaduomenims gauti.
links.certificatestringKelias PDF atsisiųsti. Reikalingas autentifikavimas.

Klaidų atsakymai

BūsenaklaidaReikšmė
400invalid_urlLaukas url nenurodytas arba nėra galiojantis https:// adresas.
400invalid_jsonUžklausos turinys nėra galiojantis JSON.
401invalid_api_keyTrūksta antraštės Authorization arba ji negalioja.
402api_access_requiredJūsų paskyra neturi Pro plano. Prenumeruokite.
403subscription_requiredŽiniatinklio sertifikatams reikalinga fiksuoto mokesčio prenumerata.
403insufficient_scopeAPI raktas neturi certificates:write srities.
413payload_too_largeUžklausos turinys viršija 64 KB.
429quota_exceededPasiekta dienos API užfiksavimų kvota. Atsinaujina kiekvieną dieną.
429rate_limitedPer daug užklausų. Žr. antraštę Retry-After.
429service_busyUžfiksavimo paslauga viršijo pajėgumą. Bandykite dar kartą po ~30 sekundžių.
502capture_failedNaršyklė negalėjo įkelti URL.
502certification_failedUžfiksavus negauta tinkamų įrodymų (pvz., tuščias HAR).

GET /api/v1/certificates/:recordingId

Gauna anksčiau sukurto sertifikato metaduomenis.

Kelio parametrai

ParametrasAprašymas
recordingIdprivalomasrecordingId, grąžintas POST /api/v1/certificates užklausos.

Atsakymas 200 OK

LaukasTipasAprašymas
certificateIdstringŽmogui suprantamas sertifikato ID.
recordingIdstringVidinis įrašo UUID.
typestringĮrašo tipas (pvz., "webcapture").
statusstring"ready", kai sertifikatas pasiekiamas.
urlstringSertifikuotas URL.
createdAtstringISO 8601 sukūrimo laiko žyma.
linksobjectkeliai self ir certificate.

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

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).

Autentifikavimas

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.

Užklausų apribojimai ir kvotos

~30

Užklausos per minutę

30 užklausų per minutę nuolat (šuoliu: 30). Viršijus grąžinama 429 rate_limited su antrašte Retry-After.

Per dieną

Dienos užfiksavimų kvota

Pro planas suteikia fiksuotą sertifikatų kūrimų skaičių per dieną. Kvota atsinaujina kiekvieną dieną. Ją viršijus grąžinama 429 quota_exceeded.

64 KB

Užklausos turinio riba

JSON užklausos turinys negali viršyti 64 KB. Praktiškai URL yra gerokai mažesnis už šią ribą.

Kodo pavyzdžiai

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

Dažniausiai užduodami klausimai

Kiek trunka sertifikato sukūrimas?

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.

Ar API palaiko failų sertifikatus (PDF, įkeliami vaizdai)?

Dabartinė API palaiko tik svetainių (URL) sertifikavimą. Failų įkėlimas galimas per žiniatinklio sąsają adresu secure.instantproof.legal/certificates/new.

Ar galiu patikrinti per API sukurtą sertifikatą?

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ę.

Kas nutinka, jei URL nepasiekiamas?

Užfiksavimo paslauga grąžina 502 capture_failed klaidą. Jūsų dienos kvota neišnaudojama.

Ar per API sukurti sertifikatai matomi žiniatinklio skydelyje?

Taip. Kiekvienas per API sukurtas sertifikatas rodomas Jūsų Sertifikatų skydelyje skiltyje Mano svetainių sertifikatai kartu su sertifikatais, sukurtais per žiniatinklio sąsają.