Żądania na minutę
30 żądań na minutę w trybie ciągłym (szczyt: 30). Przekroczenie zwraca 429 rate_limited z nagłówkiem Retry-After.
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.
Można zapisać stronę internetową, nagrać sesję przeglądarki lub poświadczyć plik.
Kryptograficzna pieczęć i znacznik czasu pomagają wykryć późniejsze zmiany.
Każdy może niezależnie sprawdzić pakiet dowodowy.
Można zacząć od 10 € kredytu powitalnego i zachować kryptograficznie opieczętowany pakiet dowodowy, który można pobrać i zweryfikować.
Trzy kroki od zera do podpisanego certyfikatu PDF.
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.
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"
}
}
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.
Bazowy adres URL: https://secure.instantproof.legal
Wszystkie punkty końcowe zwracają JSON. Uwierzytelnianie: Authorization: Bearer <key>.
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.
| Pole | Typ | Opis | |
|---|---|---|---|
url | string | wymagane | Prawidłowy adres https:// do certyfikacji. Musi być publicznie dostępny. |
| Pole | Typ | Opis |
|---|---|---|
certificateId | string | Czytelny identyfikator certyfikatu (widoczny w pliku PDF). |
recordingId | string | Wewnętrzny identyfikator UUID nagrania. Używany w kolejnych wywołaniach API. |
url | string | Przesłany adres URL. |
finalUrl | string | Adres URL po ewentualnych przekierowaniach, widziany przez przeglądarkę. |
status | string | "ready" — certyfikat jest od razu dostępny. |
links.self | string | Ścieżka do pobrania metadanych tego certyfikatu. |
links.certificate | string | Ścieżka do pobrania pliku PDF. Wymaga uwierzytelnienia. |
| Status | błąd | Znaczenie |
|---|---|---|
| 400 | invalid_url | Pole url jest puste lub nie jest prawidłowym adresem https://. |
| 400 | invalid_json | Treść żądania nie jest prawidłowym JSON. |
| 401 | invalid_api_key | Brakujący lub nieprawidłowy nagłówek Authorization. |
| 402 | api_access_required | Państwa konto nie ma planu Pro. Subskrybuj. |
| 403 | subscription_required | Certyfikaty stron internetowych wymagają subskrypcji ryczałtowej. |
| 403 | insufficient_scope | Klucz API nie ma zakresu certificates:write. |
| 413 | payload_too_large | Treść żądania przekracza 64 KB. |
| 429 | quota_exceeded | Osiągnięto dzienny limit zrzutów przez API. Limit jest odnawiany codziennie. |
| 429 | rate_limited | Zbyt wiele żądań. Zob. nagłówek Retry-After. |
| 429 | service_busy | Usługa zrzutów strony jest przeciążona. Proszę spróbować ponownie po ok. 30 sekundach. |
| 502 | capture_failed | Przeglądarka nie mogła załadować adresu URL. |
| 502 | certification_failed | Zrzut nie dał użytecznych dowodów (np. pusty plik HAR). |
Pobiera metadane wcześniej utworzonego certyfikatu.
| Parametr | Opis | |
|---|---|---|
recordingId | wymagane | Wartość recordingId zwrócona przez POST /api/v1/certificates. |
| Pole | Typ | Opis |
|---|---|---|
certificateId | string | Czytelny identyfikator certyfikatu. |
recordingId | string | Wewnętrzny identyfikator UUID nagrania. |
type | string | Typ nagrania (np. "webcapture"). |
status | string | "ready", gdy certyfikat jest dostępny. |
url | string | Certyfikowany adres URL. |
createdAt | string | Znacznik czasu utworzenia w formacie ISO 8601. |
links | object | Ścieżki self i certificate. |
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).
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.
30 żądań na minutę w trybie ciągłym (szczyt: 30). Przekroczenie zwraca 429 rate_limited z nagłówkiem Retry-After.
Plan Pro daje stałą liczbę certyfikatów do utworzenia dziennie. Limit jest odnawiany codziennie. Przekroczenie zwraca 429 quota_exceeded.
Treść żądania JSON nie może przekraczać 64 KB. W praktyce adres URL mieści się w tym limicie z dużym zapasem.
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
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.
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.
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.
Usługa zrzutu strony zwraca błąd 502 capture_failed. Dzienny limit nie zostaje zużyty.
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.