Pieprasījumi minūtē
30 pieprasījumi minūtē ilgstoši (uzliesmojums: 30). Pārsniedzot, tiek atgriezts 429 rate_limited ar galveni Retry-After.
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ē.
Saglabājiet tīmekļa lapu, ierakstiet pārlūkprogrammas sesiju vai sertificējiet failu.
Kriptogrāfisks zīmogs un laika zīmogs palīdz atklāt vēlākas izmaiņas.
Ikviens var neatkarīgi pārbaudīt pierādījumu pakotni.
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.
Trīs soļi no nulles līdz parakstītam sertifikāta PDF.
Piesakieties, atveriet Developer → API keys un noklikšķiniet uz Create API key. Nokopējiet atslēgu — tā tiek parādīta tikai vienu reizi.
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"
}
}
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.
Bāzes URL: https://secure.instantproof.legal
Visi galapunkti atgriež JSON. Autentifikācija: Authorization: Bearer <key>.
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.
| Lauks | Tips | Apraksts | |
|---|---|---|---|
url | string | obligāts | Derīgs https:// URL, ko sertificēt. Jābūt publiski pieejamam. |
| Lauks | Tips | Apraksts |
|---|---|---|
certificateId | string | Cilvēkam lasāms sertifikāta ID (redzams PDF). |
recordingId | string | Iekšējais ieraksta UUID. Izmantojiet turpmākajos API izsaukumos. |
url | string | Jūsu iesniegtais URL. |
finalUrl | string | URL pēc visām novirzīšanām, kā to redz pārlūkprogramma. |
status | string | "ready" — sertifikāts ir pieejams nekavējoties. |
links.self | string | Ceļš, pa kuru iegūt šī sertifikāta metadatus. |
links.certificate | string | Ceļš PDF lejupielādei. Nepieciešama autentifikācija. |
| Statuss | kļūda | Nozīme |
|---|---|---|
| 400 | invalid_url | Lauks url trūkst vai nav derīga https:// adrese. |
| 400 | invalid_json | Pieprasījuma pamatteksts nav derīgs JSON. |
| 401 | invalid_api_key | Trūkst galvenes Authorization vai tā nav derīga. |
| 402 | api_access_required | Jūsu kontam nav Pro plāna. Abonēt. |
| 403 | subscription_required | Tīmekļa sertifikātiem nepieciešams abonements ar fiksētu maksu. |
| 403 | insufficient_scope | API atslēgai nav piekļuves tvēruma certificates:write. |
| 413 | payload_too_large | Pieprasījuma pamatteksts pārsniedz 64 KB. |
| 429 | quota_exceeded | Sasniegta dienas API tveršanas kvota. Atjaunojas katru dienu. |
| 429 | rate_limited | Pārāk daudz pieprasījumu. Skatiet galveni Retry-After. |
| 429 | service_busy | Tveršanas pakalpojums ir pilnībā noslogots. Mēģiniet vēlreiz pēc ~30 sekundēm. |
| 502 | capture_failed | Pārlūkprogramma nevarēja ielādēt URL. |
| 502 | certification_failed | Tveršana nedeva izmantojamus pierādījumus (piem., tukšs HAR). |
Iegūst iepriekš izveidota sertifikāta metadatus.
| Parametrs | Apraksts | |
|---|---|---|
recordingId | obligāts | recordingId, ko atgriezis POST /api/v1/certificates. |
| Lauks | Tips | Apraksts |
|---|---|---|
certificateId | string | Cilvēkam lasāms sertifikāta ID. |
recordingId | string | Iekšējais ieraksta UUID. |
type | string | Ieraksta tips (piem., "webcapture"). |
status | string | "ready", tiklīdz sertifikāts ir pieejams. |
url | string | Sertificētais URL. |
createdAt | string | ISO 8601 izveides laikspiedols. |
links | object | Ceļi self un certificate. |
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).
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.
30 pieprasījumi minūtē ilgstoši (uzliesmojums: 30). Pārsniedzot, tiek atgriezts 429 rate_limited ar galveni Retry-After.
Pro plāns piešķir noteiktu sertifikātu izveides skaitu dienā. Kvota atjaunojas katru dienu. Pārsniedzot to, tiek atgriezts 429 quota_exceeded.
JSON pieprasījuma pamattekstam nedrīkst pārsniegt 64 KB. Praksē URL ir krietni zem šī ierobežojuma.
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
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.
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.
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.
Tveršanas pakalpojums atgriež kļūdu 502 capture_failed. Jūsu dienas kvota netiek iztērēta.
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ē.