API Pembuatan PDF v1 — Tanpa kewarganegaraan

API Pembuatan PDF
dari templat bisnis

Hasilkan PDF dari templat HTML, DOCX, Markdown, atau JSON Anda. Nol retensi data — tidak ada dokumen atau data yang disimpan.

Dapatkan Kunci API Anda Panduan Memulai Cepat

4 format masukan

Substitusi variabel

Penyimpanan data nol

SLA waktu aktif 99,9%.

Mulai Cepat

Dapatkan PDF pertama Anda dalam waktu kurang dari 2 menit. Buat kunci API, kirim permintaan, dan unduh hasilnya.

Dapatkan kunci API Anda

Buat kunci API dari konsol di bawah atau dari dasbor Anda.

Kunci API Anda bersifat rahasia. Jangan pernah mengeksposnya dalam kode frontend.

Kirim permintaan pertama Anda

Gunakan perintah cURL berikut untuk menghasilkan 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

Unduh PDF Anda

API mengembalikan biner PDF langsung di isi respons.

PDF yang dihasilkan disimpan ke file yang ditentukan dalam flag --output.

Demo Langsung

Coba API di sini — edit konten dan variabel, lalu tekan Hasilkan untuk langsung melihat PDF Anda.

Masuk untuk mencoba demo

Buat akun gratis untuk mengakses taman bermain langsung dan hasilkan hingga 5 PDF demo.

Buat akun Masuk

Konsol API

Kelola kunci API Anda dan pantau penggunaan langsung dari halaman ini.

Diperlukan masuk

Silakan masuk untuk membuat dan mengelola kunci API Anda.

Buat akun Masuk

Otentikasi

Semua permintaan API memerlukan kunci API yang dikirim melalui header X-API-Key.

Bagaimana cara kerjanya

Buat kunci API dari konsol atau dasbor.
Sertakan dalam setiap permintaan sebagai header X-API-Key.
API memvalidasi kunci Anda dan memeriksa kuota Anda.
Kunci yang tidak valid atau dicabut menghasilkan kesalahan 401.

Jaga keamanan kunci API Anda. Gunakan variabel lingkungan, jangan pernah melakukan hardcode dalam kode sumber.

Contoh permintaan

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

Respons kunci tidak valid (401)

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

Format Masukan

EasyPDF mendukung 4 format masukan. Pilih salah satu yang paling sesuai dengan alur kerja Anda.

HTML

Dukungan penuh CSS, piksel sempurna melalui Chromium

DOCX

Unggah templat Word dengan placeholder variabel

Markdown

5 tema bawaan untuk dokumen indah

Template JSON

Mesin kanvas untuk kontrol tata letak yang presisi

HTML → PDF

Paling Populer

Kirim HTML apa pun dengan CSS sebaris. Mesin rendering Chromium memastikan keluaran sempurna piksel yang cocok dengan tampilan browser.

Fitur Utama

Dukungan penuh CSS3 (Flexbox, Grid, pertanyaan media)
Header & footer khusus dengan nomor halaman
Substitusi variabel dengan sintaks {{variable}}
Tata letak responsif dengan ukuran halaman 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" }
}

Titik Akhir API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Hasilkan PDF dari konten HTML, Markdown, atau Templat JSON.

Request Body (JSON)

Parameter	Jenis	Diperlukan	Keterangan
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	String konten HTML atau Markdown (diperlukan untuk html/markdown)
`template_data`	`object`	Yes*	Objek templat JSON (diperlukan untuk format templat)
`variables`	`object`	No	Pasangan kunci-nilai untuk substitusi variabel
`options`	`object`	No	Opsi pembuatan PDF (format halaman, margin, dll.)

Tanggapan

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Unggah file DOCX untuk dikonversi ke PDF dengan penggantian variabel opsional.

Form Fields

Field	Jenis	Diperlukan	Keterangan
`file`	File	Yes	File .docx yang akan dikonversi
`variables`	string (JSON)	No	Pasangan kunci-nilai untuk substitusi variabel
`options`	string (JSON)	No	Opsi PDF sebagai string JSON

POST/generate/previewAPI Key

Hasilkan pratinjau PNG dari halaman pertama, bukan PDF lengkap.

200Content-Type: image/png

GET/usageAPI Key

Periksa penggunaan bulanan Anda saat ini dan sisa kuota.

Response (200)

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

POST/keysJWT Bearer

Buat kunci API baru (memerlukan otentikasi JWT).

GET/keysJWT Bearer

Cantumkan semua kunci API Anda dengan statistik penggunaan.

DELETE/keys/:key_idJWT Bearer

Cabut (nonaktifkan) kunci API secara permanen.

Contoh Kode

Contoh lengkap dan siap pakai dalam bahasa dan format pilihan Anda. Pilih bahasa dan format masukan di bawah.

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

Kasus Penggunaan

Lihat bagaimana tim menggunakan API EasyPDF untuk mengotomatiskan pembuatan dokumen dalam skala besar.

Faktur & Tanda Terima

Hasilkan faktur bermerek dengan item baris dinamis, total, dan detail klien.

HTML / DOCX

Kontrak & Perjanjian

Isi templat Word dengan data klien dan konversikan ke PDF untuk ditandatangani.

DOCX

Sertifikat & Diploma

Buat sertifikat yang dipersonalisasi dengan tata letak dan posisi yang tepat.

Template JSON

Laporan & Dasbor

Ubah data Markdown atau HTML menjadi laporan PDF yang sempurna.

Markdown / HTML

Surat & Surat

Hasilkan surat yang dipersonalisasi dari templat DOCX untuk pengiriman massal.

DOCX

Dokumen Kepatuhan

Menghasilkan dokumen kepatuhan yang siap diaudit dan anti rusak.

HTML

Opsi PDF

Sesuaikan output dengan parameter opsional ini di objek opsi.

Option	Jenis	Bawaan	Keterangan
`page_format`	`string`	`"A4"`	Ukuran halaman: A4, Letter, Legal, Tabloid, atau custom
`landscape`	`boolean`	`false`	Aktifkan orientasi lanskap
`margin_top`	`string`	`"20mm"`	Margin atas (unit CSS: mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Margin bawah
`margin_left`	`string`	`"15mm"`	Margin kiri
`margin_right`	`string`	`"15mm"`	Margin kanan
`header_html`	`string`	`null`	Konten HTML untuk header halaman
`footer_html`	`string`	`null`	Konten HTML untuk footer halaman (mendukung pageNumber, totalPages)
`theme`	`string`	`"modern"`	Tema penurunan harga: modern, klasik, minimal, github, akademik

Contoh opsi lengkap

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

Penanganan Kesalahan

API mengembalikan kesalahan JSON terstruktur dengan kode kesalahan yang konsisten.

Format respons kesalahan

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

HTTP	Error	Kapan	Apa yang harus dilakukan
`400`	`missing_content`	Bidang yang wajib diisi tidak ada	Periksa bidang isi permintaan
`400`	`invalid_json`	Penguraian JSON gagal	Validasi payload JSON Anda
`400`	`unsupported_format`	Nilai format tidak diketahui	Gunakan html, penurunan harga, atau templat
`401`	`invalid_api_key`	Kunci API tidak ditemukan	Verifikasi header X-API-Key Anda
`402`	`quota_exceeded`	Kuota bulanan terlampaui	Tingkatkan paket Anda atau tunggu pengaturan ulang
`403`	`api_key_revoked`	Kunci telah dicabut	Buat kunci API baru
`429`	`rate_limit_exceeded`	Batas nilai tercapai	Tunggu dan coba lagi dengan backoff eksponensial
`500`	`generation_failed`	Kesalahan pemrosesan internal	Periksa konten Anda apakah ada kesalahan dan coba lagi

Batas Tarif & Kuota

Setiap paket memiliki kuota PDF bulanan dan batas tarif per menit.

Pembatasan Nilai

Permintaan yang melebihi batas tarif Anda akan menerima respons 429 dengan header Coba Lagi Setelah.

Respons dengan tingkat terbatas

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

Kuota Bulanan

Penggunaan disetel ulang pada tanggal 1 setiap bulan pada tengah malam UTC.

Plan	PDFs/bulan	Rate limit	Harga	Lebihan
Starter	500	10/min	9€/bulan	0,02€/PDF
Business	5 000	30/min	79€/bulan	0,01€/PDF
Enterprise	Kebiasaan	Kebiasaan	Pada kutipan	Bisa dinegosiasikan

Praktik Terbaik

Ikuti rekomendasi berikut untuk mendapatkan hasil maksimal dari API.

Gunakan variabel untuk konten dinamis

Jaga agar templat Anda tetap statis dan masukkan data melalui objek variabel. Ini lebih efisien daripada membangun kembali HTML pada setiap panggilan.

Tangani kesalahan dengan anggun

Selalu periksa kode status HTTP. Terapkan percobaan ulang dengan backoff eksponensial untuk kesalahan 429 dan 5xx.

Optimalkan template Anda

Minimalkan CSS, hindari aset eksternal (sebariskan), dan uji template sebelum diterapkan ke produksi.

Pantau penggunaan Anda

Gunakan titik akhir /usage atau konsol di atas untuk melacak konsumsi dan menghindari batas kuota yang tidak terduga.

Amankan kunci API Anda

Simpan kunci dalam variabel lingkungan atau manajer rahasia. Putar kunci secara berkala dan cabut kunci yang tidak digunakan.

Harga

Penetapan harga yang sederhana dan transparan. Bayar hanya untuk apa yang Anda gunakan.

Starter

9€/bulan

~0,018€ / PDF

500 PDFs / bulan
10 permintaan/mnt
Semua 4 format masukan
Pembuatan pratinjau PNG
Dukungan email
Lebihan : 0,02€/PDF

Memulai

Nilai Terbaik

Business

79€/bulan

~0,016€ / PDF

5 000 PDFs / bulan
30 permintaan/mnt
Semua fitur Pemula
Dukungan prioritas
Dasbor analitik penggunaan
Lebihan : 0,01€/PDF