Kehittäjille · REST API

Automatisoi digitaalisen sisällön todentaminen API:n avulla

Tallenna · Sinetöi · Varmista

InstantProofin REST API:n avulla voit todentaa minkä tahansa julkisen URL-osoitteen ohjelmallisesti. Tunnistaudu Bearer-API-avaimella, lähetä POST-pyyntö URL-osoitteella ja saat allekirjoitetun todistuksen PDF-muodossa sekä täydellisen todistepaketin — samalla RFC 3161 -aikaleimalla ja Ed25519-allekirjoituksella kuin verkkokäyttöliittymässä.

Kokeile heti, tiliä ei tarvita.Ensimmäinen todisteesi on ilmainen · 10 € tervetuloveloitus, kun vahvistat sähköpostisi · Korttia ei tarvitaLanseeraustarjous. Hyvityksen voi käyttää myös verkkosivujen tallennuksiin tai tiedostojen sertifiointiin.
RESTJSON HTTPS:n yli
BearerAPI-avaimella tunnistautuminen
RFC 3161Kvalifioidut aikaleimat
Havainnekuva API-todentamisesta
  1. 01

    Tallenna

    Tallenna verkkosivu, kuvaa selainistunto tai sertifioi tiedosto.

  2. 02

    Sinetöi

    Kryptografinen sinetti ja aikaleima auttavat paljastamaan myöhemmät muutokset.

  3. 03

    Varmista

    Kuka tahansa voi tarkistaa todistuspaketin itsenäisesti.

Digitaalinen todistusaineisto. Tehty helpoksi.

Tallenna, mikä on tärkeää. Ennen kuin se muuttuu.

Aloita 10 €:n tervetuloveloituksella. Säilytä kryptografisesti sinetöity todistuspaketti, jonka voit ladata ja varmistaa.

Tallenna ensimmäinen todisteesi →

Edellytykset

1
Pro-tilaus tai korkeampiAPI edellyttää Pro -tilausta (api_access-ominaisuus). Tilaa täällä.
2
API-avainLuo sellainen kohdassa Asetukset → API-avaimet. Kopioi avain heti — se näytetään vain kerran.
3
Todennettava https://-osoiteAPI todentaa julkisesti tavoitettavia verkkosivuja. URL-osoitteen on oltava kelvollinen https://-osoite.

Pikaopas

Kolme vaihetta tyhjästä allekirjoitettuun PDF-todistukseen.

Vaihe 1 — Luo API-avain

Kirjaudu sisään, siirry kohtaan Kehittäjät → API-avaimet ja napsauta Luo API-avain. Kopioi avain — se näytetään vain kerran.

Vaihe 2 — Luo todistus

Lähetä POST-pyyntö URL-osoitteellasi:

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

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

Vaihe 3 — Lataa PDF-todistus

Seuraa links.certificate-URL-osoitetta API-avaimellasi. Palvelin palauttaa 302-uudelleenohjauksen esiallekirjoitettuun latausosoitteeseen:

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

Ladattu PDF on sama allekirjoitettu PDF-todistus, jonka verkkokäyttöliittymä tuottaa, ja sen voi todentaa osoitteessa /certificate.html.

API-viite

Perus-URL: https://secure.instantproof.legal
Kaikki päätepisteet palauttavat JSONia. Tunnistautuminen: Authorization: Bearer <key>.

POST /api/v1/certificates

Luo uusi verkkosivustotodistus. Alusta tallentaa URL-osoitteen ilman näyttöä toimivalla selaimella, tuottaa HAR-verkkolokin ja kuvakaappauksen, allekirjoittaa luettelon Ed25519:llä ja ankkuroi sen kvalifioituun RFC 3161 -aikaleimaan. Toimenpide kestää 10–60 sekuntia.

Pyynnön runko (JSON)

KenttäTyyppiKuvaus
urlstringpakollinenKelvollinen todennettava https://-osoite. Sen on oltava julkisesti tavoitettavissa.

Vastaus 201 Created

KenttäTyyppiKuvaus
certificateIdstringIhmisluettava todistustunnus (näkyy PDF:ssä).
recordingIdstringSisäinen tallenteen UUID. Käytä seuraavissa API-kutsuissa.
urlstringLähettämäsi URL-osoite.
finalUrlstringURL-osoite mahdollisten uudelleenohjausten jälkeen selaimen näkemänä.
statusstring"ready" — todistus on heti saatavilla.
links.selfstringPolku tämän todistuksen metatietojen hakemiseen.
links.certificatestringPolku PDF:n lataamiseen. Vaatii tunnistautumisen.

Virhevastaukset

TilavirheMerkitys
400invalid_urlurl-kenttä puuttuu tai ei ole kelvollinen https://-osoite.
400invalid_jsonPyynnön runko ei ole kelvollista JSONia.
401invalid_api_keyAuthorization-otsake puuttuu tai on virheellinen.
402api_access_requiredTililläsi ei ole Pro-tilausta. Tilaa.
403subscription_requiredVerkkotodistukset edellyttävät kiinteähintaista tilausta.
403insufficient_scopeAPI-avaimelta puuttuu certificates:write-oikeus.
413payload_too_largePyynnön runko ylittää 64 KB.
429quota_exceededAPI-tallennusten päiväkiintiö on täynnä. Nollautuu joka päivä.
429rate_limitedLiian monta pyyntöä. Katso Retry-After-otsake.
429service_busyTallennuspalvelun kapasiteetti on täynnä. Yritä uudelleen noin 30 sekunnin kuluttua.
502capture_failedSelain ei pystynyt lataamaan URL-osoitetta.
502certification_failedTallennus ei tuottanut käyttökelpoista todistusaineistoa (esim. tyhjä HAR).

GET /api/v1/certificates/:recordingId

Hae aiemmin luomasi todistuksen metatiedot.

Polkuparametrit

ParametriKuvaus
recordingIdpakollinenPOST /api/v1/certificates -pyynnön palauttama recordingId.

Vastaus 200 OK

KenttäTyyppiKuvaus
certificateIdstringIhmisluettava todistustunnus.
recordingIdstringSisäinen tallenteen UUID.
typestringTallenteen tyyppi (esim. "webcapture").
statusstring"ready", kun todistus on saatavilla.
urlstringTodennettu URL-osoite.
createdAtstringLuontiaika ISO 8601 -muodossa.
linksobjectself- ja certificate-polut.

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

Lataa allekirjoitettu PDF-todistus. Palauttaa 302 Found — seuraa uudelleenohjausta saadaksesi tiedoston. Käytä curl -L tai requests.get(..., allow_redirects=True).

Tunnistautuminen

Kaikkien API-pyyntöjen on sisällettävä:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Avaimet luodaan osoitteessa Asetukset → Kehittäjät → API-avaimet. Avain tunnistaa sinut tilisi haltijana — käsittele sitä kuin salasanaa. Peruuta se heti, jos se vuotaa.

Tuotantotilien avainten etuliite on ip_live_. Etuliitteestä avaimet tunnistaa koodista tai ympäristötiedostoista.

Pyyntörajat & kiintiöt

~30

Pyyntöjä minuutissa

30 pyyntöä minuutissa jatkuvasti (purske: 30). Ylitys palauttaa 429 rate_limited ja Retry-After-otsakkeen.

Päivittäin

Päivittäinen tallennuskiintiö

Pro-tilaus oikeuttaa kiinteään määrään todistuksia päivässä. Kiintiö nollautuu joka päivä. Ylitys palauttaa 429 quota_exceeded.

64 KB

Pyynnön rungon koko

JSON-pyynnön runko saa olla enintään 64 KB. Käytännössä URL-osoite on tämän rajan reilusti alle.

Koodiesimerkit

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

Usein kysytyt kysymykset

Kuinka kauan todistuksen luominen kestää?

Yleensä 10–60 sekuntia kohdesivun latausajasta riippuen. POST-pyyntö odottaa, kunnes todistus on valmis — erillistä kyselyvaihetta ei ole.

Tukeeko API tiedostotodistuksia (PDF, kuvien lataukset)?

Nykyinen API tukee vain verkkosivustojen (URL) todentamista. Tiedostojen lataus onnistuu verkkokäyttöliittymässä osoitteessa secure.instantproof.legal/certificates/new.

Voinko todentaa API:lla luodun todistuksen?

Kyllä. API:n tuottama PDF on identtinen verkkokäyttöliittymässä luodun kanssa. Vedä se osoitteeseen instantproof.legal/certificate.html, niin Ed25519-allekirjoitus ja RFC 3161 -aikaleimaketju tarkistetaan.

Mitä tapahtuu, jos URL-osoite ei ole tavoitettavissa?

Tallennuspalvelu palauttaa 502 capture_failed -virheen. Päiväkiintiötäsi ei kuluteta.

Näkyvätkö API:lla luodut todistukset verkkohallintapaneelissa?

Kyllä. Jokainen API:lla luotu todistus näkyy Todistukset-hallintapaneelissa kohdassa Omat verkkosivustotodistukseni verkkokäyttöliittymässä luotujen todistusten rinnalla.