За разработчици · REST API

Автоматизирайте сертифицирането на цифрово съдържание чрез API

Заснемете · Запечатайте · Проверете

REST API на InstantProof позволява програмно сертифициране на всеки публичен URL адрес. Удостоверете се с API ключ тип Bearer, изпратете с POST URL адрес и получете подписан PDF сертификат с пълен пакет с доказателства — със същото времево удостоверяване по RFC 3161 и подпис Ed25519 като в уеб интерфейса.

Опитайте сега, без акаунт.Първото Ви доказателство е безплатно · приветствен кредит от 10 € при потвърждаване на имейла · Не е нужна картаСтартова оферта. Кредитът може да се използва и за заснемане на уеб страници или сертифициране на файлове.
RESTJSON през HTTPS
BearerУдостоверяване с API ключ
RFC 3161Квалифицирани времеви удостоверявания
Илюстрация на сертифицирането чрез API
  1. 01

    Заснемете

    Запазете уеб страница, запишете сесия в браузър или сертифицирайте файл.

  2. 02

    Запечатайте

    Криптографски печат и времеви печат помагат да се разкрият по-късни промени.

  3. 03

    Проверете

    Всеки може да провери пакета с доказателства независимо.

Цифрови доказателства. Просто.

Заснемете важното. Преди да се е променило.

Започнете с приветствен кредит от 10 €. Запазете криптографски запечатан пакет с доказателства, който можете да изтеглите и проверите.

Заснемете първото си доказателство →

Предварителни условия

1
План Pro или по-високAPI изисква абонамент Pro (функция api_access). Абонирайте се тук.
2
API ключСъздайте го в Настройки → API ключове. Копирайте ключа веднага — показва се само веднъж.
3
URL адрес с https:// за сертифициранеAPI сертифицира публично достъпни уеб страници. URL адресът трябва да е валиден адрес с https://.

Бърз старт

Три стъпки от нулата до подписан PDF сертификат.

Стъпка 1 — Създайте API ключ

Влезте в профила си, отидете на Разработчици → API ключове и щракнете върху Създаване на API ключ. Копирайте ключа — показва се само веднъж.

Стъпка 2 — Създайте сертификат

Изпратете POST заявка с Вашия 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"}'

Отговор 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 — Изтеглете PDF сертификата

Последвайте URL адреса links.certificate с Вашия API ключ. Сървърът връща пренасочване 302 към предварително подписан URL адрес за изтегляне:

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

Изтегленият PDF файл е същият подписан PDF сертификат, който създава уеб интерфейсът, и може да се провери на /certificate.html.

API справочник

Основен URL адрес: https://secure.instantproof.legal
Всички крайни точки връщат JSON. Удостоверяване: Authorization: Bearer <key>.

POST /api/v1/certificates

Създава нов сертификат за уебсайт. Платформата заснема URL адреса в браузър без графичен интерфейс (headless), създава мрежов дневник HAR и снимка на екрана, подписва манифеста с Ed25519 и го свързва с квалифицирано времево удостоверяване по RFC 3161. Операцията отнема 10–60 секунди.

Тяло на заявката (JSON)

ПолеТипОписание
urlstringзадължителноВалиден URL адрес с https:// за сертифициране. Трябва да е публично достъпен.

Отговор 201 Created

ПолеТипОписание
certificateIdstringЧетим за човек идентификатор на сертификата (показан в PDF файла).
recordingIdstringВътрешен UUID на записа. Използвайте го в последващи API извиквания.
urlstringИзпратеният от Вас URL адрес.
finalUrlstringURL адресът след евентуални пренасочвания, както го вижда браузърът.
statusstring"ready" — сертификатът е веднага достъпен.
links.selfstringПът за извличане на метаданните на този сертификат.
links.certificatestringПът за изтегляне на PDF файла. Изисква удостоверяване.

Отговори с грешка

СтатусгрешкаЗначение
400invalid_urlПолето url липсва или не е валиден адрес с https://.
400invalid_jsonТялото на заявката не е валиден JSON.
401invalid_api_keyЛипсващ или невалиден хедър Authorization.
402api_access_requiredПрофилът Ви няма план Pro. Абонирайте се.
403subscription_requiredУеб сертификатите изискват абонамент с фиксирана цена.
403insufficient_scopeAPI ключът няма обхват certificates:write.
413payload_too_largeТялото на заявката надвишава 64 KB.
429quota_exceededДостигната е дневната квота за заснемане чрез API. Подновява се всеки ден.
429rate_limitedТвърде много заявки. Вижте хедъра Retry-After.
429service_busyУслугата за заснемане е на пълен капацитет. Опитайте отново след около 30 секунди.
502capture_failedБраузърът не успя да зареди URL адреса.
502certification_failedЗаснемането не е дало използваемо доказателство (напр. празен HAR).

GET /api/v1/certificates/:recordingId

Извлича метаданните на сертификат, който сте създали преди това.

Параметри на пътя

ПараметърОписание
recordingIdзадължителноrecordingId, върнат от POST /api/v1/certificates.

Отговор 200 OK

ПолеТипОписание
certificateIdstringЧетим за човек идентификатор на сертификата.
recordingIdstringВътрешен UUID на записа.
typestringВид на записа (напр. "webcapture").
statusstring"ready", когато сертификатът е достъпен.
urlstringСертифицираният URL адрес.
createdAtstringВремеви отпечатък на създаването във формат ISO 8601.
linksobjectПътища self и certificate.

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

Изтегля подписания PDF сертификат. Връща 302 Found — последвайте пренасочването, за да получите файла. Използвайте curl -L или requests.get(..., allow_redirects=True).

Удостоверяване

Всички API заявки трябва да включват:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Ключовете се създават в Настройки → Разработчици → API ключове. Ключът се удостоверява като Вашия профил — отнасяйте се към него като към парола. При изтичане го отнемете незабавно.

Ключовете са с префикс ip_live_ за активни профили. Префиксът Ви помага да ги разпознавате в кода или в конфигурационните файлове на средата.

Ограничения на честотата & квоти

~30

Заявки в минута

30 заявки в минута продължително (пик: 30). При превишаване се връща 429 rate_limited с хедър Retry-After.

Дневна

Дневна квота за заснемане

Планът Pro дава фиксиран брой създавания на сертификати на ден. Квотата се подновява всеки ден. При превишаване се връща 429 quota_exceeded.

64 KB

Ограничение на тялото на заявката

JSON тялото на заявката не трябва да надвишава 64 KB. На практика един URL адрес е доста под това ограничение.

Примери с код

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

Често задавани въпроси

Колко време отнема създаването на сертификат?

Обикновено 10–60 секунди, в зависимост от времето за зареждане на целевата страница. POST заявката блокира, докато сертификатът е готов — няма стъпка на периодично запитване.

Поддържа ли API сертификати за файлове (PDF, качени изображения)?

Към момента API поддържа само сертифициране на уебсайтове (URL). Качването на файлове е налично през уеб интерфейса на secure.instantproof.legal/certificates/new.

Мога ли да проверя сертификат, създаден чрез API?

Да. PDF файлът, създаден чрез API, е идентичен със създадения през уеб интерфейса. Плъзнете го върху instantproof.legal/certificate.html, за да проверите подписа Ed25519 и веригата на времевото удостоверяване по RFC 3161.

Какво се случва, ако URL адресът е недостъпен?

Услугата за заснемане връща грешка 502 capture_failed. Дневната Ви квота не се изразходва.

Виждат ли се сертификатите, създадени чрез API, в уеб таблото?

Да. Всеки сертификат, създаден чрез API, се появява в таблото Ви Сертификати под Моите сертификати за уебсайтове, заедно със сертификатите, създадени през уеб интерфейса.