Quick start

1. Create a free account and copy your API key from the dashboard. The Free plan includes 50 PDFs a month.

2. Send your HTML to POST https://getprintoza.com/v1/convert with your key in the x-api-key header. The answer is the PDF file itself.

Hızlı başlangıç

1. Ücretsiz hesap açın ve panelden API anahtarınızı kopyalayın. Ücretsiz planda ayda 50 PDF hakkı var.

2. HTML’inizi POST https://getprintoza.com/v1/convert adresine, anahtarınızı x-api-key başlığında göndererek yollayın. Yanıt, PDF dosyasının kendisidir.

curl -X POST https://getprintoza.com/v1/convert \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello</h1><p>My first PDF.</p>", "format": "A4"}' \
  --output document.pdf

const fs = require("fs");

async function makePdf() {
  const res = await fetch("https://getprintoza.com/v1/convert", {
    method: "POST",
    headers: {
      "x-api-key": process.env.GETPRINTOZA_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ html: "<h1>Hello</h1><p>My first PDF.</p>", format: "A4" }),
  });

  if (!res.ok) throw new Error((await res.json()).error);
  fs.writeFileSync("document.pdf", Buffer.from(await res.arrayBuffer()));
}

makePdf();

import os
import requests

res = requests.post(
    "https://getprintoza.com/v1/convert",
    headers={"x-api-key": os.environ["GETPRINTOZA_KEY"]},
    json={"html": "<h1>Hello</h1><p>My first PDF.</p>", "format": "A4"},
    timeout=60,
)

if res.ok:
    with open("document.pdf", "wb") as f:
        f.write(res.content)
else:
    print(res.json())

Keep your key on your server. Never put it in a web page or mobile app that other people can open.

Anahtarınızı kendi sunucunuzda tutun. Başkalarının açabileceği bir web sayfasına veya mobil uygulamaya koymayın.

POST /v1/convert

Turns HTML into a PDF. Send JSON with the header x-api-key and Content-Type: application/json.

A successful answer is status 200 with the PDF as the body. The header X-Quota-Remaining tells you how many PDFs are left this month.

Empty-box warning. If your HTML contains characters that none of our fonts can draw, the PDF is still made, but those characters would show up as empty boxes. In that case the answer also has the header X-Getprintoza-Warnings, for example unsupported_characters; count=2; U+2603,U+1F9FF (the count, then up to 20 character codes). No header means nothing was found. It is a best-effort check and it is skipped when your HTML loads its own web fonts.

POST /v1/convert

HTML’i PDF’e çevirir. x-api-key ve Content-Type: application/json başlıklarıyla JSON gönderin.

Başarılı yanıt 200 durum koduyla gelir ve gövdesi PDF’tir. X-Quota-Remaining başlığı bu ay kaç PDF hakkınız kaldığını söyler.

Boş kutu uyarısı. HTML’inizde hiçbir fontumuzun çizemediği karakterler varsa PDF yine hazırlanır, ama o karakterler boş kutu olarak görünür. Bu durumda yanıtta ayrıca X-Getprintoza-Warnings başlığı olur; örneğin unsupported_characters; count=2; U+2603,U+1F9FF (önce sayı, sonra en çok 20 karakter kodu). Başlık yoksa sorun bulunmadı demektir. Bu en iyi çaba kontrolüdür; HTML’iniz kendi web fontunu yüklüyorsa atlanır.

HTTP/1.1 200 OK
Content-Type: application/pdf
X-Quota-Remaining: 987

Arabic example. Arabic and Hebrew documents are set to right-to-left for you, and the right fonts are already installed. If you prefer to control it yourself, add dir="ltr" or dir="rtl" to your <html> tag and we will not change it.

Arapça örneği. Arapça ve İbranice belgeler sizin için kendiliğinden sağdan sola ayarlanır, gerekli yazı tipleri de sunucuda hazırdır. Kendiniz belirlemek isterseniz <html> etiketinize dir="ltr" veya dir="rtl" yazın, biz dokunmayız.

curl -X POST https://getprintoza.com/v1/convert \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>مرحبا</h1><p>فاتورة مبيعات</p>", "language": "ar"}' \
  --output arabic.pdf

Errors

When something goes wrong you get a JSON body like the one below, with the status codes in this table.

Hatalar

Bir sorun olduğunda aşağıdaki gibi bir JSON gövdesi ve bu tablodaki durum kodlarından biri gelir.

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

{ "error": "quota_exceeded", "plan": "free", "limit": 50 }

GET /v1/usage

Shows your plan and how many PDFs you have used this month. Checking usage does not use up a PDF.

GET /v1/usage

Planınızı ve bu ay kaç PDF kullandığınızı gösterir. Kullanımı sorgulamak PDF hakkınızdan düşmez.

curl https://getprintoza.com/v1/usage -H "x-api-key: YOUR_API_KEY"

{ "plan": "starter", "usedThisMonth": 13, "monthlyLimit": 1000, "remaining": 987 }

GET /v1/languages

Lists the language codes you can use in the language field. No API key needed.

GET /v1/languages

language alanında kullanabileceğiniz dil kodlarını listeler. API anahtarı gerekmez.

curl https://getprintoza.com/v1/languages

{ "enabled": [ { "code": "en", "name": "English", ... }, { "code": "ar", "name": "العربية", ... } ] }

Good to know

• Each PDF that is built counts as one against your monthly plan. If we fail to build it, it is not counted.
• Speed limit: up to 10 requests a minute on the Free plan and 60 a minute on paid plans. Going over returns too_many_requests.
• JavaScript in your HTML does not run. Send finished HTML and CSS.
• Public images, stylesheets and fonts on https addresses load. Addresses on private networks are blocked. For the most reliable result, put images inside the HTML as data: links.
• Pages have 15 mm margins and backgrounds are printed.
• We do not save your HTML or your PDF.
• Need a new key or a bigger plan? Both are in the dashboard. Questions: support@getprintoza.com.

Bilmekte fayda var

• Üretilen her PDF, aylık planınızdan 1 hak düşer. PDF’i üretemezsek hakkınızdan düşmez.
• Hız sınırı: Ücretsiz planda dakikada 10, ücretli planlarda dakikada 60 istek. Aşarsanız too_many_requests döner.
• HTML’inizdeki JavaScript çalışmaz. Hazır HTML ve CSS gönderin.
• https adreslerindeki herkese açık görseller, stil dosyaları ve yazı tipleri yüklenir. Özel ağ adresleri engellenir. En sağlam sonuç için görselleri HTML’in içine data: bağlantısı olarak koyun.
• Sayfa kenar boşlukları 15 mm’dir ve arka planlar basılır.
• HTML’inizi ve PDF’inizi kaydetmeyiz.
• Yeni anahtar mı, daha büyük plan mı lazım? İkisi de panelde. Sorularınız için: support@getprintoza.com.