Заявки в минута
30 заявки в минута продължително (пик: 30). При превишаване се връща 429 rate_limited с хедър Retry-After.
REST API на InstantProof позволява програмно сертифициране на всеки публичен URL адрес. Удостоверете се с API ключ тип Bearer, изпратете с POST URL адрес и получете подписан PDF сертификат с пълен пакет с доказателства — със същото времево удостоверяване по RFC 3161 и подпис Ed25519 като в уеб интерфейса.
Запазете уеб страница, запишете сесия в браузър или сертифицирайте файл.
Криптографски печат и времеви печат помагат да се разкрият по-късни промени.
Всеки може да провери пакета с доказателства независимо.
Започнете с приветствен кредит от 10 €. Запазете криптографски запечатан пакет с доказателства, който можете да изтеглите и проверите.
Три стъпки от нулата до подписан PDF сертификат.
Влезте в профила си, отидете на Разработчици → API ключове и щракнете върху Създаване на API ключ. Копирайте ключа — показва се само веднъж.
Изпратете 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"
}
}
Последвайте 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.
Основен URL адрес: https://secure.instantproof.legal
Всички крайни точки връщат JSON. Удостоверяване: Authorization: Bearer <key>.
Създава нов сертификат за уебсайт. Платформата заснема URL адреса в браузър без графичен интерфейс (headless), създава мрежов дневник HAR и снимка на екрана, подписва манифеста с Ed25519 и го свързва с квалифицирано времево удостоверяване по RFC 3161. Операцията отнема 10–60 секунди.
| Поле | Тип | Описание | |
|---|---|---|---|
url | string | задължително | Валиден URL адрес с https:// за сертифициране. Трябва да е публично достъпен. |
| Поле | Тип | Описание |
|---|---|---|
certificateId | string | Четим за човек идентификатор на сертификата (показан в PDF файла). |
recordingId | string | Вътрешен UUID на записа. Използвайте го в последващи API извиквания. |
url | string | Изпратеният от Вас URL адрес. |
finalUrl | string | URL адресът след евентуални пренасочвания, както го вижда браузърът. |
status | string | "ready" — сертификатът е веднага достъпен. |
links.self | string | Път за извличане на метаданните на този сертификат. |
links.certificate | string | Път за изтегляне на PDF файла. Изисква удостоверяване. |
| Статус | грешка | Значение |
|---|---|---|
| 400 | invalid_url | Полето url липсва или не е валиден адрес с https://. |
| 400 | invalid_json | Тялото на заявката не е валиден JSON. |
| 401 | invalid_api_key | Липсващ или невалиден хедър Authorization. |
| 402 | api_access_required | Профилът Ви няма план Pro. Абонирайте се. |
| 403 | subscription_required | Уеб сертификатите изискват абонамент с фиксирана цена. |
| 403 | insufficient_scope | API ключът няма обхват certificates:write. |
| 413 | payload_too_large | Тялото на заявката надвишава 64 KB. |
| 429 | quota_exceeded | Достигната е дневната квота за заснемане чрез API. Подновява се всеки ден. |
| 429 | rate_limited | Твърде много заявки. Вижте хедъра Retry-After. |
| 429 | service_busy | Услугата за заснемане е на пълен капацитет. Опитайте отново след около 30 секунди. |
| 502 | capture_failed | Браузърът не успя да зареди URL адреса. |
| 502 | certification_failed | Заснемането не е дало използваемо доказателство (напр. празен HAR). |
Извлича метаданните на сертификат, който сте създали преди това.
| Параметър | Описание | |
|---|---|---|
recordingId | задължително | recordingId, върнат от POST /api/v1/certificates. |
| Поле | Тип | Описание |
|---|---|---|
certificateId | string | Четим за човек идентификатор на сертификата. |
recordingId | string | Вътрешен UUID на записа. |
type | string | Вид на записа (напр. "webcapture"). |
status | string | "ready", когато сертификатът е достъпен. |
url | string | Сертифицираният URL адрес. |
createdAt | string | Времеви отпечатък на създаването във формат ISO 8601. |
links | object | Пътища self и certificate. |
Изтегля подписания PDF сертификат. Връща 302 Found — последвайте пренасочването, за да получите файла. Използвайте curl -L или requests.get(..., allow_redirects=True).
Всички API заявки трябва да включват:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Ключовете се създават в Настройки → Разработчици → API ключове. Ключът се удостоверява като Вашия профил — отнасяйте се към него като към парола. При изтичане го отнемете незабавно.
Ключовете са с префикс ip_live_ за активни профили. Префиксът Ви помага да ги разпознавате в кода или в конфигурационните файлове на средата.
30 заявки в минута продължително (пик: 30). При превишаване се връща 429 rate_limited с хедър Retry-After.
Планът Pro дава фиксиран брой създавания на сертификати на ден. Квотата се подновява всеки ден. При превишаване се връща 429 quota_exceeded.
JSON тялото на заявката не трябва да надвишава 64 KB. На практика един URL адрес е доста под това ограничение.
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
Обикновено 10–60 секунди, в зависимост от времето за зареждане на целевата страница. POST заявката блокира, докато сертификатът е готов — няма стъпка на периодично запитване.
Към момента API поддържа само сертифициране на уебсайтове (URL). Качването на файлове е налично през уеб интерфейса на secure.instantproof.legal/certificates/new.
Да. PDF файлът, създаден чрез API, е идентичен със създадения през уеб интерфейса. Плъзнете го върху instantproof.legal/certificate.html, за да проверите подписа Ed25519 и веригата на времевото удостоверяване по RFC 3161.
Услугата за заснемане връща грешка 502 capture_failed. Дневната Ви квота не се изразходва.
Да. Всеки сертификат, създаден чрез API, се появява в таблото Ви Сертификати под Моите сертификати за уебсайтове, заедно със сертификатите, създадени през уеб интерфейса.