PDF Oluşturma API'si v1 - Durum Bilgisiz

PDF Oluşturma API'si
iş şablonlarından

HTML, DOCX, Markdown veya JSON şablonlarınızdan PDF'ler oluşturun. Sıfır veri saklama — hiçbir belge veya veri saklanmaz.

API Anahtarınızı Alın Hızlı Başlangıç Kılavuzu

4 giriş formatı

Değişken ikame

Sıfır veri depolama

%99,9 kesintisiz çalışma HDS'si

Hızlı Başlangıç

İlk PDF'nizi 2 dakikadan kısa sürede alın. Bir API anahtarı oluşturun, bir istek gönderin ve sonucu indirin.

API anahtarınızı alın

Aşağıdaki konsoldan veya kontrol panelinizden bir API anahtarı oluşturun.

API anahtarınız bir sırdır. Asla ön uç kodunda göstermeyin.

İlk isteğinizi gönderin

PDF oluşturmak için aşağıdaki cURL komutunu kullanın:

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

PDF'nizi indirin

API, PDF ikili dosyasını doğrudan yanıt gövdesinde döndürür.

Oluşturulan PDF --output bayrağında belirtilen dosyaya kaydedilir.

Canlı Demo

API'yi hemen burada deneyin; içeriği ve değişkenleri düzenleyin, ardından PDF'nizi anında görmek için Oluştur'a basın.

Demoyu denemek için oturum açın

Canlı oyun alanına erişmek ve 5 adede kadar demo PDF oluşturmak için ücretsiz bir hesap oluşturun.

Hesap oluşturmak Oturum aç

API Konsolu

API anahtarlarınızı yönetin ve kullanımı doğrudan bu sayfadan izleyin.

Oturum açmanız gerekiyor

API anahtarlarınızı oluşturmak ve yönetmek için lütfen oturum açın.

Hesap oluşturmak Oturum aç

Kimlik doğrulama

Tüm API istekleri, X-API-Key başlığı aracılığıyla gönderilen bir API anahtarı gerektirir.

Nasıl çalışır?

Konsoldan veya kontrol panelinden bir API anahtarı oluşturun.
Bunu her isteğe X-API-Key başlığı olarak ekleyin.
API, anahtarınızı doğrular ve kotanızı kontrol eder.
Geçersiz veya iptal edilen anahtarlar 401 hatası döndürür.

API anahtarınızı güvende tutun. Ortam değişkenlerini kullanın, asla kaynak koduna sabit kod yazmayın.

Örnek istek

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

Geçersiz anahtar yanıtı (401)

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

Giriş Formatları

EasyPDF 4 giriş formatını destekler. İş akışınıza en uygun olanı seçin.

HTML

Tam CSS desteği, Chromium aracılığıyla mükemmel piksel

DOCX

Değişken yer tutuculara sahip Word şablonlarını yükleme

Markdown

Güzel belgeler için 5 yerleşik tema

Template JSON

Hassas düzen kontrolü için tuval motoru

HTML → PDF

En Popüler

Herhangi bir HTML'yi satır içi CSS ile gönderin. Chromium işleme motoru, tarayıcı ekranıyla eşleşen piksel mükemmelliğinde çıktı sağlar.

Temel Özellikler

Tam CSS3 desteği (Flexbox, Grid, medya sorguları)
Sayfa numaralarına sahip özel üstbilgiler ve altbilgiler
{{variable}} sözdizimi ile değişken değiştirme
A4/Letter/Legal sayfa boyutlarına sahip duyarlı düzenler

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

API Uç Noktaları

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

HTML, Markdown veya Template JSON içeriğinden PDF oluşturun.

Request Body (JSON)

Parametre	Tip	Gerekli	Tanım
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	HTML veya Markdown içerik dizesi (html/markdown için gereklidir)
`template_data`	`object`	Yes*	Şablon JSON nesnesi (şablon formatı için gereklidir)
`variables`	`object`	No	Değişken ikamesi için anahtar/değer çiftleri
`options`	`object`	No	PDF oluşturma seçenekleri (sayfa formatı, kenar boşlukları vb.)

Cevap

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

İsteğe bağlı değişken değiştirmeyle PDF'ye dönüştürmek için bir DOCX dosyası yükleyin.

Form Fields

Field	Tip	Gerekli	Tanım
`file`	File	Yes	Dönüştürülecek .docx dosyası
`variables`	string (JSON)	No	Değişken ikamesi için anahtar/değer çiftleri
`options`	string (JSON)	No	JSON dizesi olarak PDF seçenekleri

POST/generate/previewAPI Key

Tam PDF yerine ilk sayfanın PNG önizlemesini oluşturun.

200Content-Type: image/png

GET/usageAPI Key

Mevcut aylık kullanımınızı ve kalan kotanızı kontrol edin.

Response (200)

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

POST/keysJWT Bearer

Yeni bir API anahtarı oluşturun (JWT kimlik doğrulaması gerektirir).

GET/keysJWT Bearer

Tüm API anahtarlarınızı kullanım istatistikleriyle birlikte listeleyin.

DELETE/keys/:key_idJWT Bearer

Bir API anahtarını kalıcı olarak iptal edin (devre dışı bırakın).

Kod Örnekleri

Tercih ettiğiniz dil ve formatta eksiksiz, kullanıma hazır örnekler. Aşağıdan bir dil ve giriş formatı seçin.

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

Kullanım Durumları

Ekiplerin belge oluşturmayı geniş ölçekte otomatikleştirmek için EasyPDF API'yi nasıl kullandığını görün.

Faturalar ve Makbuzlar

Dinamik satır öğeleri, toplamlar ve müşteri ayrıntılarıyla markalı faturalar oluşturun.

HTML / DOCX

Sözleşmeler ve Anlaşmalar

Word şablonlarını istemci verileriyle doldurun ve imzalamak için PDF'ye dönüştürün.

DOCX

Sertifikalar ve Diplomalar

Hassas düzen ve konumlandırmayla kişiselleştirilmiş sertifikalar oluşturun.

Template JSON

Raporlar ve Kontrol Panelleri

Markdown veya HTML verilerini gösterişli PDF raporlarına dönüştürün.

Markdown / HTML

Mektuplar ve Postalar

Toplu postalar için DOCX şablonlarından kişiselleştirilmiş mektuplar oluşturun.

DOCX

Uyumluluk Belgeleri

Denetime hazır, kurcalamaya dayanıklı uyumluluk belgeleri üretin.

HTML

PDF Seçenekleri

Çıktıyı seçenekler nesnesindeki bu isteğe bağlı parametrelerle özelleştirin.

Option	Tip	Varsayılan	Tanım
`page_format`	`string`	`"A4"`	Sayfa boyutu: A4, Letter, Legal, Tabloid veya özel
`landscape`	`boolean`	`false`	Yatay yönlendirmeyi etkinleştir
`margin_top`	`string`	`"20mm"`	Üst kenar boşluğu (CSS birimleri: mm, cm, inç, piksel)
`margin_bottom`	`string`	`"20mm"`	Alt kenar boşluğu
`margin_left`	`string`	`"15mm"`	Sol kenar boşluğu
`margin_right`	`string`	`"15mm"`	Sağ kenar boşluğu
`header_html`	`string`	`null`	Sayfa başlığı için HTML içeriği
`footer_html`	`string`	`null`	Sayfa altbilgisi için HTML içeriği (pageNumber, totalPages'i destekler)
`theme`	`string`	`"modern"`	Markdown teması: modern, klasik, minimal, github, akademik

Tam seçenekler örneği

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

Hata İşleme

API, tutarlı hata kodlarıyla yapılandırılmış JSON hatalarını döndürür.

Hata yanıt formatı

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

HTTP	Error	Ne zaman	Ne yapalım
`400`	`missing_content`	Gerekli alan eksik	İstek gövdesi alanlarını kontrol edin
`400`	`invalid_json`	JSON ayrıştırma başarısız oldu	JSON verinizi doğrulayın
`400`	`unsupported_format`	Bilinmeyen biçim değeri	Html, işaretleme veya şablon kullanın
`401`	`invalid_api_key`	API anahtarı bulunamadı	X-API-Key başlığınızı doğrulayın
`402`	`quota_exceeded`	Aylık kota aşıldı	Planınızı yükseltin veya sıfırlamayı bekleyin
`403`	`api_key_revoked`	Anahtar iptal edildi	Yeni bir API anahtarı oluşturun
`429`	`rate_limit_exceeded`	Oran sınırına ulaşıldı	Üstel geri çekilmeyle bekleyin ve yeniden deneyin
`500`	`generation_failed`	Dahili işleme hatası	İçeriğinizde hata olup olmadığını kontrol edin ve yeniden deneyin

Fiyat Sınırları ve Kotalar

Her planın aylık bir PDF kotası ve dakika başına ücret sınırı vardır.

Hız Sınırlaması

Hız sınırınızı aşan istekler, Retry-After başlığıyla 429 yanıtı alır.

Hız sınırlı yanıt

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

Aylık Kotalar

Kullanım her ayın 1'inde gece yarısı UTC'de sıfırlanır.

Plan	PDFs/ay	Rate limit	Fiyat	Fazlalık
Starter	500	10/min	9€/ay	0,02€/PDF
Business	5 000	30/min	79€/ay	0,01€/PDF
Enterprise	Gelenek	Gelenek	Alıntıda	Pazarlık edilebilir

En İyi Uygulamalar

API'den en iyi şekilde yararlanmak için bu önerileri izleyin.

Dinamik içerik için değişkenleri kullanma

Şablonlarınızı statik tutun ve değişkenler nesnesi aracılığıyla verileri enjekte edin. Bu, her çağrıda HTML'yi yeniden oluşturmaktan daha etkilidir.

Hataları zarif bir şekilde ele alın

Her zaman HTTP durum kodunu kontrol edin. 429 ve 5xx hataları için üstel gerileme ile yeniden denemeler uygulayın.

Şablonlarınızı optimize edin

Üretime dağıtmadan önce CSS'yi en aza indirin, harici varlıklardan kaçının (satır içi) ve şablonları test edin.

Kullanımınızı izleyin

Tüketimi izlemek ve beklenmeyen kota sınırlamalarından kaçınmak için /usage uç noktasını veya yukarıdaki konsolu kullanın.

API anahtarlarınızı koruyun

Anahtarları ortam değişkenlerinde veya gizli yöneticilerde saklayın. Anahtarları periyodik olarak değiştirin ve kullanılmayanları iptal edin.

Fiyatlandırma

Basit, şeffaf fiyatlandırma. Yalnızca kullandığınız kadar ödeyin.

Starter

9€/ay

~0,018€ / PDF

500 PDFs / ay
10 istek/dakika
4 giriş formatının tümü
PNG önizleme oluşturma
E-posta desteği
Fazlalık : 0,02€/PDF

Başlayın

En İyi Değer

Business

79€/ay

~0,016€ / PDF

5 000 PDFs / ay
30 istek/dakika
Tüm Başlangıç özellikleri
Öncelikli destek
Kullanım analizi kontrol paneli
Fazlalık : 0,01€/PDF