Pyyntöjä minuutissa
30 pyyntöä minuutissa jatkuvasti (purske: 30). Ylitys palauttaa 429 rate_limited ja Retry-After-otsakkeen.
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ä.
Tallenna verkkosivu, kuvaa selainistunto tai sertifioi tiedosto.
Kryptografinen sinetti ja aikaleima auttavat paljastamaan myöhemmät muutokset.
Kuka tahansa voi tarkistaa todistuspaketin itsenäisesti.
Aloita 10 €:n tervetuloveloituksella. Säilytä kryptografisesti sinetöity todistuspaketti, jonka voit ladata ja varmistaa.
Kolme vaihetta tyhjästä allekirjoitettuun PDF-todistukseen.
Kirjaudu sisään, siirry kohtaan Kehittäjät → API-avaimet ja napsauta Luo API-avain. Kopioi avain — se näytetään vain kerran.
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"
}
}
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.
Perus-URL: https://secure.instantproof.legal
Kaikki päätepisteet palauttavat JSONia. Tunnistautuminen: Authorization: Bearer <key>.
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.
| Kenttä | Tyyppi | Kuvaus | |
|---|---|---|---|
url | string | pakollinen | Kelvollinen todennettava https://-osoite. Sen on oltava julkisesti tavoitettavissa. |
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
certificateId | string | Ihmisluettava todistustunnus (näkyy PDF:ssä). |
recordingId | string | Sisäinen tallenteen UUID. Käytä seuraavissa API-kutsuissa. |
url | string | Lähettämäsi URL-osoite. |
finalUrl | string | URL-osoite mahdollisten uudelleenohjausten jälkeen selaimen näkemänä. |
status | string | "ready" — todistus on heti saatavilla. |
links.self | string | Polku tämän todistuksen metatietojen hakemiseen. |
links.certificate | string | Polku PDF:n lataamiseen. Vaatii tunnistautumisen. |
| Tila | virhe | Merkitys |
|---|---|---|
| 400 | invalid_url | url-kenttä puuttuu tai ei ole kelvollinen https://-osoite. |
| 400 | invalid_json | Pyynnön runko ei ole kelvollista JSONia. |
| 401 | invalid_api_key | Authorization-otsake puuttuu tai on virheellinen. |
| 402 | api_access_required | Tililläsi ei ole Pro-tilausta. Tilaa. |
| 403 | subscription_required | Verkkotodistukset edellyttävät kiinteähintaista tilausta. |
| 403 | insufficient_scope | API-avaimelta puuttuu certificates:write-oikeus. |
| 413 | payload_too_large | Pyynnön runko ylittää 64 KB. |
| 429 | quota_exceeded | API-tallennusten päiväkiintiö on täynnä. Nollautuu joka päivä. |
| 429 | rate_limited | Liian monta pyyntöä. Katso Retry-After-otsake. |
| 429 | service_busy | Tallennuspalvelun kapasiteetti on täynnä. Yritä uudelleen noin 30 sekunnin kuluttua. |
| 502 | capture_failed | Selain ei pystynyt lataamaan URL-osoitetta. |
| 502 | certification_failed | Tallennus ei tuottanut käyttökelpoista todistusaineistoa (esim. tyhjä HAR). |
Hae aiemmin luomasi todistuksen metatiedot.
| Parametri | Kuvaus | |
|---|---|---|
recordingId | pakollinen | POST /api/v1/certificates -pyynnön palauttama recordingId. |
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
certificateId | string | Ihmisluettava todistustunnus. |
recordingId | string | Sisäinen tallenteen UUID. |
type | string | Tallenteen tyyppi (esim. "webcapture"). |
status | string | "ready", kun todistus on saatavilla. |
url | string | Todennettu URL-osoite. |
createdAt | string | Luontiaika ISO 8601 -muodossa. |
links | object | self- ja certificate-polut. |
Lataa allekirjoitettu PDF-todistus. Palauttaa 302 Found — seuraa uudelleenohjausta saadaksesi tiedoston. Käytä curl -L tai requests.get(..., allow_redirects=True).
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.
30 pyyntöä minuutissa jatkuvasti (purske: 30). Ylitys palauttaa 429 rate_limited ja Retry-After-otsakkeen.
Pro-tilaus oikeuttaa kiinteään määrään todistuksia päivässä. Kiintiö nollautuu joka päivä. Ylitys palauttaa 429 quota_exceeded.
JSON-pyynnön runko saa olla enintään 64 KB. Käytännössä URL-osoite on tämän rajan reilusti alle.
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
Yleensä 10–60 sekuntia kohdesivun latausajasta riippuen. POST-pyyntö odottaa, kunnes todistus on valmis — erillistä kyselyvaihetta ei ole.
Nykyinen API tukee vain verkkosivustojen (URL) todentamista. Tiedostojen lataus onnistuu verkkokäyttöliittymässä osoitteessa secure.instantproof.legal/certificates/new.
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.
Tallennuspalvelu palauttaa 502 capture_failed -virheen. Päiväkiintiötäsi ei kuluteta.
Kyllä. Jokainen API:lla luotu todistus näkyy Todistukset-hallintapaneelissa kohdassa Omat verkkosivustotodistukseni verkkokäyttöliittymässä luotujen todistusten rinnalla.