Izstrādātājiem · REST API

Automatizējiet digitālā satura sertificēšanu ar API

Iegūstiet · Apzīmogojiet · Pārbaudiet

InstantProof REST API ļauj programmatiski sertificēt jebkuru publisku URL. Autentificējieties ar Bearer API atslēgu, nosūtiet POST ar URL un saņemiet parakstītu sertifikāta PDF ar pilnu pierādījumu paketi — ar to pašu RFC 3161 laikspiedolu un Ed25519 parakstu kā tīmekļa saskarnē.

Izmēģiniet tūlīt, konts nav vajadzīgs.Jūsu pirmais pierādījums ir bezmaksas · 10 € sveiciena kredīts pēc e-pasta apstiprināšanas · Karte nav nepieciešamaAtklāšanas piedāvājums. Kredītu var izmantot arī tīmekļa lapu tvērumiem vai failu sertificēšanai.
RESTJSON pār HTTPS
BearerAPI atslēgas autentifikācija
RFC 3161Kvalificēti laikspiedoli
API sertificēšanas ilustrācija
  1. 01

    Iegūstiet

    Saglabājiet tīmekļa lapu, ierakstiet pārlūkprogrammas sesiju vai sertificējiet failu.

  2. 02

    Apzīmogojiet

    Kriptogrāfisks zīmogs un laika zīmogs palīdz atklāt vēlākas izmaiņas.

  3. 03

    Pārbaudiet

    Ikviens var neatkarīgi pārbaudīt pierādījumu pakotni.

Digitālie pierādījumi. Vienkārši.

Iegūstiet svarīgo. Pirms tas mainās.

Sāciet ar 10 € sveiciena kredītu. Saglabājiet kriptogrāfiski apzīmogotu pierādījumu pakotni, ko varat lejupielādēt un pārbaudīt.

Iegūstiet savu pirmo pierādījumu →

Priekšnosacījumi

1
Pro plāns vai augstāksAPI nepieciešams Pro abonements (funkcija api_access). Abonēt šeit.
2
API atslēgaIzveidojiet to sadaļā Settings → API keys. Nekavējoties nokopējiet atslēgu — tā tiek parādīta tikai vienu reizi.
3
https:// URL, ko sertificētAPI sertificē publiski pieejamas tīmekļa lapas. URL jābūt derīgai https:// adresei.

Ātrā sākšana

Trīs soļi no nulles līdz parakstītam sertifikāta PDF.

1. solis — izveidojiet API atslēgu

Piesakieties, atveriet Developer → API keys un noklikšķiniet uz Create API key. Nokopējiet atslēgu — tā tiek parādīta tikai vienu reizi.

2. solis — izveidojiet sertifikātu

Nosūtiet POST pieprasījumu ar savu 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"}'

Atbilde 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. solis — lejupielādējiet sertifikāta PDF

Atveriet URL links.certificate ar savu API atslēgu. Serveris atgriež 302 novirzīšanu uz iepriekš parakstītu lejupielādes URL:

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

Lejupielādētais PDF ir tas pats parakstītais sertifikāta PDF, ko izveido tīmekļa saskarne; to var pārbaudīt vietnē /certificate.html.

API atsauce

Bāzes URL: https://secure.instantproof.legal
Visi galapunkti atgriež JSON. Autentifikācija: Authorization: Bearer <key>.

POST /api/v1/certificates

Izveido jaunu vietnes sertifikātu. Platforma ielādē URL bezgalvas pārlūkprogrammā, izveido HAR tīkla žurnālu un ekrānuzņēmumu, paraksta manifestu ar Ed25519 un piesaista to kvalificētam RFC 3161 laikspiedolam. Darbība aizņem 10–60 sekundes.

Pieprasījuma pamatteksts (JSON)

LauksTipsApraksts
urlstringobligātsDerīgs https:// URL, ko sertificēt. Jābūt publiski pieejamam.

Atbilde 201 Created

LauksTipsApraksts
certificateIdstringCilvēkam lasāms sertifikāta ID (redzams PDF).
recordingIdstringIekšējais ieraksta UUID. Izmantojiet turpmākajos API izsaukumos.
urlstringJūsu iesniegtais URL.
finalUrlstringURL pēc visām novirzīšanām, kā to redz pārlūkprogramma.
statusstring"ready" — sertifikāts ir pieejams nekavējoties.
links.selfstringCeļš, pa kuru iegūt šī sertifikāta metadatus.
links.certificatestringCeļš PDF lejupielādei. Nepieciešama autentifikācija.

Kļūdu atbildes

StatusskļūdaNozīme
400invalid_urlLauks url trūkst vai nav derīga https:// adrese.
400invalid_jsonPieprasījuma pamatteksts nav derīgs JSON.
401invalid_api_keyTrūkst galvenes Authorization vai tā nav derīga.
402api_access_requiredJūsu kontam nav Pro plāna. Abonēt.
403subscription_requiredTīmekļa sertifikātiem nepieciešams abonements ar fiksētu maksu.
403insufficient_scopeAPI atslēgai nav piekļuves tvēruma certificates:write.
413payload_too_largePieprasījuma pamatteksts pārsniedz 64 KB.
429quota_exceededSasniegta dienas API tveršanas kvota. Atjaunojas katru dienu.
429rate_limitedPārāk daudz pieprasījumu. Skatiet galveni Retry-After.
429service_busyTveršanas pakalpojums ir pilnībā noslogots. Mēģiniet vēlreiz pēc ~30 sekundēm.
502capture_failedPārlūkprogramma nevarēja ielādēt URL.
502certification_failedTveršana nedeva izmantojamus pierādījumus (piem., tukšs HAR).

GET /api/v1/certificates/:recordingId

Iegūst iepriekš izveidota sertifikāta metadatus.

Ceļa parametri

ParametrsApraksts
recordingIdobligātsrecordingId, ko atgriezis POST /api/v1/certificates.

Atbilde 200 OK

LauksTipsApraksts
certificateIdstringCilvēkam lasāms sertifikāta ID.
recordingIdstringIekšējais ieraksta UUID.
typestringIeraksta tips (piem., "webcapture").
statusstring"ready", tiklīdz sertifikāts ir pieejams.
urlstringSertificētais URL.
createdAtstringISO 8601 izveides laikspiedols.
linksobjectCeļi self un certificate.

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

Lejupielādē parakstīto sertifikāta PDF. Atgriež 302 Found — sekojiet novirzīšanai, lai saņemtu failu. Izmantojiet curl -L vai requests.get(..., allow_redirects=True).

Autentifikācija

Visiem API pieprasījumiem jāietver:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Atslēgas tiek izveidotas sadaļā Settings → Developer → API keys. Atslēga autentificējas kā Jūsu konts — izturieties pret to kā pret paroli. Ja tā noplūdusi, nekavējoties atsauciet to.

Aktīvo kontu atslēgām ir prefikss ip_live_. Prefikss palīdz tās atpazīt kodā vai vides failos.

Ātruma ierobežojumi & kvotas

~30

Pieprasījumi minūtē

30 pieprasījumi minūtē ilgstoši (uzliesmojums: 30). Pārsniedzot, tiek atgriezts 429 rate_limited ar galveni Retry-After.

Dienā

Dienas tveršanas kvota

Pro plāns piešķir noteiktu sertifikātu izveides skaitu dienā. Kvota atjaunojas katru dienu. Pārsniedzot to, tiek atgriezts 429 quota_exceeded.

64 KB

Pieprasījuma pamatteksta ierobežojums

JSON pieprasījuma pamattekstam nedrīkst pārsniegt 64 KB. Praksē URL ir krietni zem šī ierobežojuma.

Koda piemēri

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

Bieži uzdotie jautājumi

Cik ilgi aizņem sertifikāta izveide?

Parasti 10–60 sekundes atkarībā no mērķa lapas ielādes laika. POST pieprasījums tiek bloķēts, līdz sertifikāts ir gatavs — nav papildu atkārtotas pārbaudes soļa.

Vai API atbalsta failu sertifikātus (PDF, attēlu augšupielādes)?

Pašreizējais API atbalsta tikai vietņu (URL) sertificēšanu. Failu augšupielāde ir pieejama tīmekļa saskarnē secure.instantproof.legal/certificates/new.

Vai varu pārbaudīt ar API izveidotu sertifikātu?

Jā. API izveidotais PDF ir identisks tam, kas izveidots tīmekļa saskarnē. Velciet to uz instantproof.legal/certificate.html, lai pārbaudītu Ed25519 parakstu un RFC 3161 laikspiedola ķēdi.

Kas notiek, ja URL nav sasniedzams?

Tveršanas pakalpojums atgriež kļūdu 502 capture_failed. Jūsu dienas kvota netiek iztērēta.

Vai ar API izveidotie sertifikāti ir redzami tīmekļa panelī?

Jā. Katrs ar API izveidotais sertifikāts parādās Jūsu sertifikātu panelī sadaļā My Website certificates kopā ar sertifikātiem, kas izveidoti tīmekļa saskarnē.