Hızlı başlangıç

İlk belgenize beş dakika

Bu sayfa sizi sıfırdan diskteki bir PDF'e götürüyor. Her çalışma alanının hazır geldiği Fatura şablonunu kullanıyor; yani önce bir şey tasarlamanız gerekmiyor.

1. Anahtarınız

Hesap → API anahtarları altından bir anahtar oluşturun. Gizli değer bir kez gösterilir; kaynak kodunuzda durmasın. Her çağrı onu X-PDFgine-Key başlığında taşır.

# Anahtar kodun içinde değil, ortamda durur
export PDFGINE_KEY="pdfgine_live_..."

# Çalışıyor mu? Bu, şablonlarınızı listeler
curl https://api.pdfgine.com/api/v1/templates \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

2. Belgeyi üretin

Şablon kodu ve verinizle tek bir çağrı. Yanıt, documentId ve bir indirme adresi taşıyan 202.

curl -X POST https://api.pdfgine.com/api/v1/render \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "templateCode": "invoice",
        "format": "pdf",
        "locale": "tr",
        "data": {
          "document": { "title": "Fatura özeti" },
          "referenceNo": "DOC-2026-0042",
          "issueDate": "2026-09-06",
          "currency": "TRY",
          "customer": "Acme Teknoloji A.Ş.",
          "lineItems": [
            { "name": "Arıza teşhisi", "quantity": 2, "unitPrice": 850.00 }
          ]
        }
      }'

Şablonu denerken "purpose": "editor-test" gönderin: o çıktı kotanıza hiç dokunmaz ve yayımlanmamış taslağı kullanır.

3. İndirin

Yanıttaki indirme adresi API adresine göredir ve aynı anahtarla çekilir. pdf yerine docx isteyin, aynı veri Word dosyası olarak gelsin.

curl https://api.pdfgine.com/api/v1/documents/doc_a96063f5dcd5400286ce9b3be9b0595b/download/pdf \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -o invoice.pdf

İlk takılınan yerler

• 402, aylık sayfa kotasının bittiği anlamına gelir; X-PDFgine-Quota-Remaining başlığı oraya varmadan önce size söyler.
• 422, verinizin şablonu karşılamadığı anlamına gelir. Gövde eksik her alanı errors altında adıyla söyler, yani hangisi olduğunu tahmin etmeniz gerekmez.
• Üretim 200 değil 202 döner. 200 dışındaki her şeyi başarısızlık sayan bir istemci, başarıyı hata olarak raporlar.

Sırada ne var

En çok geri döneceğiniz sayfa Veri biçimleri: bir tarihin, bir tutarın ve bir para biriminin tam olarak nasıl gelmesi gerektiğini söylüyor.