PDF Generation API v1 — bezstanowy

Interfejs API generowania plików PDF
z szablonów biznesowych

Generuj pliki PDF na podstawie szablonów HTML, DOCX, Markdown lub JSON. Zero retencji danych — brak przechowywania dokumentów i danych.

Zdobądź klucz API Szybki przewodnik

4 formaty wejściowe

Substytucja zmienna

Zerowa pamięć danych

Umowa SLA dotycząca dostępności na poziomie 99,9%.

Szybki start

Zdobądź swój pierwszy plik PDF w niecałe 2 minuty. Utwórz klucz API, wyślij żądanie i pobierz wynik.

Zdobądź klucz API

Utwórz klucz API z konsoli poniżej lub z pulpitu nawigacyjnego.

Twój klucz API jest tajemnicą. Nigdy nie ujawniaj tego w kodzie frontendu.

Wyślij swoją pierwszą prośbę

Użyj następującego polecenia cURL, aby wygenerować plik PDF:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Pobierz swój plik PDF

Interfejs API zwraca plik binarny PDF bezpośrednio w treści odpowiedzi.

Wygenerowany plik PDF zostanie zapisany w pliku określonym we fladze --output.

Demo na żywo

Wypróbuj interfejs API tutaj — edytuj zawartość i zmienne, a następnie naciśnij przycisk Generuj, aby natychmiast wyświetlić plik PDF.

Zaloguj się, aby wypróbować wersję demonstracyjną

Utwórz bezpłatne konto, aby uzyskać dostęp do żywego placu zabaw i wygenerować do 5 demonstracyjnych plików PDF.

Utwórz konto Zalogować się

Konsola API

Zarządzaj kluczami API i monitoruj wykorzystanie bezpośrednio z tej strony.

Wymagane zalogowanie się

Zaloguj się, aby utworzyć klucze API i zarządzać nimi.

Utwórz konto Zalogować się

Uwierzytelnianie

Wszystkie żądania API wymagają klucza API przesłanego za pośrednictwem nagłówka X-API-Key.

Jak to działa

Utwórz klucz API z konsoli lub pulpitu nawigacyjnego.
Dołącz go do każdego żądania jako nagłówek X-API-Key.
Interfejs API weryfikuje Twój klucz i sprawdza Twój limit.
Nieprawidłowe lub unieważnione klucze zwracają błąd 401.

Chroń swój klucz API. Używaj zmiennych środowiskowych, nigdy nie koduj na stałe w kodzie źródłowym.

Przykładowe żądanie

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Nieprawidłowa odpowiedź na klucz (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Formaty wejściowe

EasyPDF obsługuje 4 formaty wejściowe. Wybierz ten, który najlepiej pasuje do Twojego przepływu pracy.

HTML

Pełna obsługa CSS, doskonała jakość pikseli dzięki Chromium

DOCX

Prześlij szablony programu Word ze zmiennymi symbolami zastępczymi

Markdown

5 wbudowanych motywów dla pięknych dokumentów

Template JSON

Silnik płótna umożliwiający precyzyjną kontrolę układu

HTML → PDF

Najpopularniejsze

Wyślij dowolny kod HTML z wbudowanym CSS. Silnik renderujący Chromium zapewnia doskonałą jakość pikseli, dopasowując się do wyświetlania przeglądarki.

Kluczowe funkcje

Pełna obsługa CSS3 (Flexbox, Grid, zapytania o media)
Niestandardowe nagłówki i stopki z numerami stron
Podstawianie zmiennych ze składnią {{variable}}
Responsywne układy z rozmiarami stron A4/Letter/Legal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Punkty końcowe interfejsu API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Wygeneruj plik PDF z zawartości HTML, Markdown lub szablonu JSON.

Request Body (JSON)

Parametr	Typ	Wymagany	Opis
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	Ciąg treści HTML lub Markdown (wymagany dla HTML/Markdown)
`template_data`	`object`	Yes*	Obiekt szablonu JSON (wymagany w przypadku formatu szablonu)
`variables`	`object`	No	Pary klucz-wartość do podstawienia zmiennych
`options`	`object`	No	Opcje generowania plików PDF (format strony, marginesy itp.)

Odpowiedź

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Prześlij plik DOCX w celu konwersji do formatu PDF z opcjonalną zamianą zmiennych.

Form Fields

Field	Typ	Wymagany	Opis
`file`	File	Yes	Plik .docx do konwersji
`variables`	string (JSON)	No	Pary klucz-wartość do podstawienia zmiennych
`options`	string (JSON)	No	Opcje PDF jako ciąg JSON

POST/generate/previewAPI Key

Wygeneruj podgląd PNG pierwszej strony zamiast pełnego pliku PDF.

200Content-Type: image/png

GET/usageAPI Key

Sprawdź swoje bieżące miesięczne wykorzystanie i pozostały limit.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Utwórz nowy klucz API (wymaga uwierzytelnienia JWT).

GET/keysJWT Bearer

Lista wszystkich kluczy API wraz ze statystykami użytkowania.

DELETE/keys/:key_idJWT Bearer

Unieważnij (dezaktywuj) klucz API na stałe.

Przykłady kodu

Kompletne, gotowe do użycia przykłady w preferowanym języku i formacie. Wybierz poniżej język i format wprowadzania.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Przypadki użycia

Zobacz, jak zespoły wykorzystują interfejs API EasyPDF do automatyzacji generowania dokumentów na dużą skalę.

Faktury i rachunki

Generuj faktury markowe z dynamicznymi pozycjami, sumami i szczegółami klienta.

HTML / DOCX

Umowy i porozumienia

Wypełniaj szablony Word danymi klientów i konwertuj je do formatu PDF w celu podpisania.

DOCX

Certyfikaty i dyplomy

Twórz spersonalizowane certyfikaty z precyzyjnym układem i pozycjonowaniem.

Template JSON

Raporty i dashboardy

Zamień dane Markdown lub HTML w dopracowane raporty PDF.

Markdown / HTML

Listy i mailingi

Generuj spersonalizowane listy na podstawie szablonów DOCX do wysyłki masowej.

DOCX

Dokumenty zgodności

Twórz gotowe do audytu i odporne na manipulacje dokumenty dotyczące zgodności.

HTML

Opcje PDF

Dostosuj dane wyjściowe za pomocą tych opcjonalnych parametrów w obiekcie opcji.

Option	Typ	Domyślny	Opis
`page_format`	`string`	`"A4"`	Rozmiar strony: A4, Letter, Legal, Tabloid lub niestandardowy
`landscape`	`boolean`	`false`	Włącz orientację poziomą
`margin_top`	`string`	`"20mm"`	Margines górny (jednostki CSS: mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Dolny margines
`margin_left`	`string`	`"15mm"`	Lewy margines
`margin_right`	`string`	`"15mm"`	Prawy margines
`header_html`	`string`	`null`	Treść HTML nagłówka strony
`footer_html`	`string`	`null`	Treść HTML stopki strony (obsługuje pageNumber, totalPages)
`theme`	`string`	`"modern"`	Motyw Markdown: nowoczesny, klasyczny, minimalny, github, akademicki

Przykład pełnych opcji

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Obsługa błędów

Interfejs API zwraca strukturalne błędy JSON ze spójnymi kodami błędów.

Format odpowiedzi na błąd

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Gdy	Co robić
`400`	`missing_content`	Brak wymaganego pola	Sprawdź pola treści żądania
`400`	`invalid_json`	Analiza JSON nie powiodła się	Sprawdź ładunek JSON
`400`	`unsupported_format`	Nieznana wartość formatu	Użyj kodu HTML, przeceny lub szablonu
`401`	`invalid_api_key`	Nie znaleziono klucza API	Sprawdź nagłówek X-API-Key
`402`	`quota_exceeded`	Przekroczono limit miesięczny	Uaktualnij swój plan lub poczekaj na reset
`403`	`api_key_revoked`	Klucz został unieważniony	Utwórz nowy klucz API
`429`	`rate_limit_exceeded`	Osiągnięto limit stawki	Poczekaj i spróbuj ponownie z wykładniczym wycofaniem
`500`	`generation_failed`	Wewnętrzny błąd przetwarzania	Sprawdź zawartość pod kątem błędów i spróbuj ponownie

Limity stawek i kwoty

Każdy plan ma miesięczny limit plików PDF i limit szybkości na minutę.

Ograniczanie szybkości

Żądania przekraczające limit szybkości otrzymują odpowiedź 429 z nagłówkiem Retry-After.

Odpowiedź o ograniczonej szybkości

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Limity miesięczne

Użycie resetuje się pierwszego dnia każdego miesiąca o północy czasu UTC.

Plan	PDFs/miesiąc	Rate limit	Cena	Nadwyżka
Starter	500	10/min	9€/miesiąc	0,02€/PDF
Business	5 000	30/min	79€/miesiąc	0,01€/PDF
Enterprise	Zwyczaj	Zwyczaj	Na cytacie	Zbywalny

Najlepsze praktyki

Postępuj zgodnie z tymi zaleceniami, aby w pełni wykorzystać możliwości interfejsu API.

Użyj zmiennych dla treści dynamicznych

Utrzymuj szablony statyczne i wstrzykiwaj dane poprzez obiekt zmiennych. Jest to bardziej wydajne niż przebudowywanie kodu HTML przy każdym wywołaniu.

Obchodź się z błędami z wdziękiem

Zawsze sprawdzaj kod stanu HTTP. Zaimplementuj ponowne próby z wykładniczym wycofywaniem dla błędów 429 i 5xx.

Zoptymalizuj swoje szablony

Zminimalizuj CSS, unikaj zasobów zewnętrznych (wstaw je) i testuj szablony przed wdrożeniem w środowisku produkcyjnym.

Monitoruj swoje użycie

Użyj punktu końcowego /usage lub powyższej konsoli, aby śledzić zużycie i unikać nieoczekiwanych limitów przydziału.

Zabezpiecz swoje klucze API

Przechowuj klucze w zmiennych środowiskowych lub w menedżerach tajnych. Okresowo zmieniaj klucze i unieważniaj te, które nie są używane.

Wycena

Prosty i przejrzysty cennik. Płać tylko za to, z czego korzystasz.

Starter

9€/miesiąc

~0,018€ / PDF

500 PDFs / miesiąc
10 żądania/min
Wszystkie 4 formaty wejściowe
Generowanie podglądu PNG
Wsparcie e-mailowe
Nadwyżka : 0,02€/PDF

Rozpocznij

Najlepsza wartość

Business

79€/miesiąc

~0,016€ / PDF

5 000 PDFs / miesiąc
30 żądania/min
Wszystkie funkcje Startera
Wsparcie priorytetowe
Pulpit nawigacyjny analizy użytkowania
Nadwyżka : 0,01€/PDF