Dla programistów · REST API

Automatyzacja certyfikacji treści cyfrowych przez API

Zabezpiecz · Opieczętuj · Zweryfikuj

REST API InstantProof pozwala certyfikować dowolny publiczny adres URL programowo. Po uwierzytelnieniu kluczem API typu Bearer wystarczy wysłać POST z adresem URL, aby otrzymać podpisany certyfikat PDF wraz z pełnym pakietem dowodowym — z tym samym znacznikiem czasu RFC 3161 i podpisem Ed25519 co w interfejsie webowym.

Wypróbuj teraz, bez zakładania konta.Pierwszy dowód jest bezpłatny · 10 € kredytu powitalnego po potwierdzeniu e-maila · Bez kartyOferta startowa. Kredyt można wykorzystać także na zapisy stron internetowych lub certyfikację plików.
RESTJSON przez HTTPS
BearerUwierzytelnianie kluczem API
RFC 3161Kwalifikowane znaczniki czasu
Ilustracja certyfikacji przez API
  1. 01

    Zabezpiecz

    Można zapisać stronę internetową, nagrać sesję przeglądarki lub poświadczyć plik.

  2. 02

    Opieczętuj

    Kryptograficzna pieczęć i znacznik czasu pomagają wykryć późniejsze zmiany.

  3. 03

    Zweryfikuj

    Każdy może niezależnie sprawdzić pakiet dowodowy.

Dowody cyfrowe. W prosty sposób.

Zabezpiecz to, co ważne. Zanim się zmieni.

Można zacząć od 10 € kredytu powitalnego i zachować kryptograficznie opieczętowany pakiet dowodowy, który można pobrać i zweryfikować.

Zabezpiecz pierwszy dowód →

Wymagania wstępne

1
Plan Pro lub wyższyAPI wymaga subskrypcji Pro (funkcja api_access). Subskrybuj tutaj.
2
Klucz APIMożna go utworzyć w Ustawienia → Klucze API. Klucz należy skopiować od razu — jest wyświetlany tylko raz.
3
Adres URL https:// do certyfikacjiAPI certyfikuje publicznie dostępne strony internetowe. Adres URL musi być prawidłowym adresem https://.

Szybki start

Trzy kroki od zera do podpisanego certyfikatu PDF.

Krok 1 — Utwórz klucz API

Proszę się zalogować, przejść do Dla programistów → Klucze API i kliknąć Utwórz klucz API. Klucz należy skopiować — jest wyświetlany tylko raz.

Krok 2 — Utwórz certyfikat

Proszę wysłać żądanie POST z adresem 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"}'

Odpowiedź 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"
  }
}

Krok 3 — Pobierz certyfikat PDF

Należy użyć adresu URL links.certificate wraz z kluczem API. Serwer zwraca przekierowanie 302 do wstępnie podpisanego adresu pobierania:

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

Pobrany plik PDF jest tym samym podpisanym certyfikatem PDF, który tworzy interfejs webowy, i można go zweryfikować pod adresem /certificate.html.

Dokumentacja API

Bazowy adres URL: https://secure.instantproof.legal
Wszystkie punkty końcowe zwracają JSON. Uwierzytelnianie: Authorization: Bearer <key>.

POST /api/v1/certificates

Tworzy nowy certyfikat strony internetowej. Platforma przechwytuje adres URL w przeglądarce bez interfejsu graficznego, tworzy dziennik sieciowy HAR i zrzut ekranu, podpisuje manifest algorytmem Ed25519 i zakotwicza go w kwalifikowanym znaczniku czasu RFC 3161. Operacja trwa 10–60 sekund.

Treść żądania (JSON)

PoleTypOpis
urlstringwymaganePrawidłowy adres https:// do certyfikacji. Musi być publicznie dostępny.

Odpowiedź 201 Created

PoleTypOpis
certificateIdstringCzytelny identyfikator certyfikatu (widoczny w pliku PDF).
recordingIdstringWewnętrzny identyfikator UUID nagrania. Używany w kolejnych wywołaniach API.
urlstringPrzesłany adres URL.
finalUrlstringAdres URL po ewentualnych przekierowaniach, widziany przez przeglądarkę.
statusstring"ready" — certyfikat jest od razu dostępny.
links.selfstringŚcieżka do pobrania metadanych tego certyfikatu.
links.certificatestringŚcieżka do pobrania pliku PDF. Wymaga uwierzytelnienia.

Odpowiedzi z błędem

StatusbłądZnaczenie
400invalid_urlPole url jest puste lub nie jest prawidłowym adresem https://.
400invalid_jsonTreść żądania nie jest prawidłowym JSON.
401invalid_api_keyBrakujący lub nieprawidłowy nagłówek Authorization.
402api_access_requiredPaństwa konto nie ma planu Pro. Subskrybuj.
403subscription_requiredCertyfikaty stron internetowych wymagają subskrypcji ryczałtowej.
403insufficient_scopeKlucz API nie ma zakresu certificates:write.
413payload_too_largeTreść żądania przekracza 64 KB.
429quota_exceededOsiągnięto dzienny limit zrzutów przez API. Limit jest odnawiany codziennie.
429rate_limitedZbyt wiele żądań. Zob. nagłówek Retry-After.
429service_busyUsługa zrzutów strony jest przeciążona. Proszę spróbować ponownie po ok. 30 sekundach.
502capture_failedPrzeglądarka nie mogła załadować adresu URL.
502certification_failedZrzut nie dał użytecznych dowodów (np. pusty plik HAR).

GET /api/v1/certificates/:recordingId

Pobiera metadane wcześniej utworzonego certyfikatu.

Parametry ścieżki

ParametrOpis
recordingIdwymaganeWartość recordingId zwrócona przez POST /api/v1/certificates.

Odpowiedź 200 OK

PoleTypOpis
certificateIdstringCzytelny identyfikator certyfikatu.
recordingIdstringWewnętrzny identyfikator UUID nagrania.
typestringTyp nagrania (np. "webcapture").
statusstring"ready", gdy certyfikat jest dostępny.
urlstringCertyfikowany adres URL.
createdAtstringZnacznik czasu utworzenia w formacie ISO 8601.
linksobjectŚcieżki self i certificate.

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

Pobiera podpisany certyfikat PDF. Zwraca 302 Found — aby otrzymać plik, należy podążyć za przekierowaniem. Należy użyć curl -L lub requests.get(..., allow_redirects=True).

Uwierzytelnianie

Wszystkie żądania API muszą zawierać:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Klucze tworzy się w Ustawienia → Dla programistów → Klucze API. Klucz uwierzytelnia jako Państwa konto — należy traktować go jak hasło. W razie wycieku należy go natychmiast unieważnić.

Klucze mają prefiks ip_live_ dla kont produkcyjnych. Prefiks ułatwia ich rozpoznanie w kodzie lub plikach środowiskowych.

Limity szybkości i dzienne limity

~30

Żądania na minutę

30 żądań na minutę w trybie ciągłym (szczyt: 30). Przekroczenie zwraca 429 rate_limited z nagłówkiem Retry-After.

Dziennie

Dzienny limit zrzutów

Plan Pro daje stałą liczbę certyfikatów do utworzenia dziennie. Limit jest odnawiany codziennie. Przekroczenie zwraca 429 quota_exceeded.

64 KB

Limit treści żądania

Treść żądania JSON nie może przekraczać 64 KB. W praktyce adres URL mieści się w tym limicie z dużym zapasem.

Przykłady kodu

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

Najczęściej zadawane pytania

Ile trwa wystawienie certyfikatu?

Zazwyczaj 10–60 sekund, w zależności od czasu ładowania docelowej strony. Żądanie POST pozostaje otwarte, dopóki certyfikat nie będzie gotowy — nie ma etapu odpytywania.

Czy API obsługuje certyfikaty plików (PDF, przesyłanie obrazów)?

Obecne API obsługuje wyłącznie certyfikację stron internetowych (URL). Przesyłanie plików jest dostępne w interfejsie webowym pod adresem secure.instantproof.legal/certificates/new.

Czy mogę zweryfikować certyfikat utworzony przez API?

Tak. Plik PDF wygenerowany przez API jest identyczny z tym utworzonym w interfejsie webowym. Wystarczy przeciągnąć go na instantproof.legal/certificate.html, aby zweryfikować podpis Ed25519 i łańcuch znacznika czasu RFC 3161.

Co się stanie, jeśli adres URL jest nieosiągalny?

Usługa zrzutu strony zwraca błąd 502 capture_failed. Dzienny limit nie zostaje zużyty.

Czy certyfikaty utworzone przez API są widoczne w panelu webowym?

Tak. Każdy certyfikat utworzony przez API pojawia się w panelu Certyfikatów w sekcji Moje certyfikaty stron internetowych, obok certyfikatów utworzonych w interfejsie webowym.