# PDF Converter API Documentation ## 🇬🇧 English ### Overview The PDF Converter API transforms web pages and raw HTML into professional PDF documents using a real Chromium browser engine. Powered by Cloudflare Workers for fast, reliable document generation. ### Authentication All requests must include your RapidAPI key in the headers. This is handled automatically when you subscribe and use the API through RapidAPI. ### Endpoints #### GET /url-to-pdf Convert a web page to PDF via query parameters. | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `url` | string | Yes | — | The full URL of the page to convert | | `format` | string | No | A4 | Paper size: A3, A4, A5, Letter, Legal, Tabloid (paid) | | `landscape` | boolean | No | false | Landscape orientation (paid) | | `scale` | float | No | 1.0 | Scale factor 0.1 - 2.0 | | `printBackground` | boolean | No | true | Include background colors/images | **Example:** ``` GET /url-to-pdf?url=https://example.com&format=A4 ``` #### POST /url-to-pdf Same as GET but with JSON body for more options. ```json { "url": "https://example.com", "options": { "format": "Letter", "landscape": true, "margin": { "top": "20mm", "bottom": "20mm" } } } ``` #### POST /html-to-pdf (Paid Plans Only) Convert raw HTML string to PDF. ```json { "html": "<html><body>

Invoice

</body></html>", "options": { "format": "A4" } } ``` ### Plan Limits | Feature | Free | Paid (Basic+) | |---------|------|---------------| | URL to PDF | Yes | Yes | | HTML to PDF | No (403) | Yes | | Paper Size | A4 only | All formats | | Orientation | Portrait only | Portrait + Landscape | | Headers/Footers | No | Yes | ### Error Codes | Status | Description | |--------|-------------| | 400 | Missing URL or invalid HTML/JSON | | 401 | Unauthorized — invalid API key | | 403 | Feature requires paid plan | | 504 | Page load timeout | | 500 | PDF generation failed | --- ## 🇹🇷 Türkçe ### Genel Bakış PDF Converter API, gerçek bir Chromium tarayıcı motoru kullanarak web sayfalarını ve ham HTML'i profesyonel PDF belgelerine dönüştürür. Cloudflare Workers üzerinde çalışır. ### Kimlik Doğrulama Tüm istekler, header'larda RapidAPI anahtarınızı içermelidir. RapidAPI üzerinden abone olduğunuzda bu otomatik olarak yapılır. ### Nasıl Kullanılır? #### URL'den PDF Oluşturma (GET) ``` GET /url-to-pdf?url=https://example.com&format=A4 ``` #### URL'den PDF Oluşturma (POST) ```json { "url": "https://ornek-site.com", "options": { "format": "A4", "landscape": false, "margin": { "top": "10mm", "bottom": "10mm" } } } ``` #### HTML'den PDF Oluşturma (Sadece Ücretli Planlar) ```json { "html": "<html><body>

Fatura #1234

Toplam: 99 TL

</body></html>", "options": { "format": "A4" } } ``` ### PDF Seçenekleri | Seçenek | Tip | Varsayılan | Açıklama | |---------|-----|------------|----------| | `format` | string | A4 | Kağıt boyutu: A3, A4, A5, Letter, Legal, Tabloid | | `landscape` | boolean | false | Yatay yönlendirme | | `scale` | float | 1.0 | Sayfa ölçeği (0.1 - 2.0) | | `printBackground` | boolean | true | Arka plan renklerini/görsellerini dahil et | | `margin` | object | 10mm | `{ top, right, bottom, left }` mm/cm/in/px cinsinden | | `displayHeaderFooter` | boolean | false | Üstbilgi ve altbilgi göster | ### Ücretsiz vs Ücretli Plan | Özellik | Ücretsiz | Ücretli (Basic+) | |---------|----------|------------------| | URL'den PDF | Var | Var | | HTML'den PDF | Yok (403) | Var | | Kağıt Boyutu | Sadece A4 | Tüm formatlar | | Yönlendirme | Sadece dikey | Dikey + Yatay | | Üstbilgi/Altbilgi | Yok | Var | ### Hata Kodları | Durum | Açıklama | |-------|----------| | 400 | Eksik URL veya geçersiz HTML/JSON | | 401 | Yetkisiz — geçersiz API anahtarı | | 403 | Özellik ücretli plan gerektiriyor | | 504 | Sayfa yükleme zaman aşımı | | 500 | PDF oluşturma başarısız | --- ## 🇩🇪 Deutsch ### Überblick Die PDF Converter API wandelt Webseiten und rohes HTML in professionelle PDF-Dokumente um, unter Verwendung einer echten Chromium-Browser-Engine. Betrieben von Cloudflare Workers für schnelle, zuverlässige Dokumentenerstellung. ### Authentifizierung Alle Anfragen müssen Ihren RapidAPI-Schlüssel in den Headers enthalten. Dies wird automatisch gehandhabt, wenn Sie die API über RapidAPI abonnieren. ### Verwendung #### PDF aus URL erstellen (GET) ``` GET /url-to-pdf?url=https://example.com&format=A4 ``` #### PDF aus URL erstellen (POST) ```json { "url": "https://beispiel-seite.de", "options": { "format": "A4", "landscape": false, "margin": { "top": "10mm", "bottom": "10mm" } } } ``` #### PDF aus HTML erstellen (Nur bezahlte Pläne) ```json { "html": "<html><body>

Rechnung #1234

Gesamt: 99€

</body></html>", "options": { "format": "A4" } } ``` ### PDF-Optionen | Option | Typ | Standard | Beschreibung | |--------|-----|----------|-------------| | `format` | string | A4 | Papiergröße: A3, A4, A5, Letter, Legal, Tabloid | | `landscape` | boolean | false | Querformat | | `scale` | float | 1.0 | Seitenskalierung (0.1 - 2.0) | | `printBackground` | boolean | true | Hintergrundfarben/-bilder einbeziehen | | `margin` | object | 10mm | `{ top, right, bottom, left }` in mm/cm/in/px | | `displayHeaderFooter` | boolean | false | Kopf- und Fußzeile anzeigen | ### Kostenlos vs Bezahlt | Funktion | Kostenlos | Bezahlt (Basic+) | |----------|-----------|------------------| | PDF aus URL | Ja | Ja | | PDF aus HTML | Nein (403) | Ja | | Papiergröße | Nur A4 | Alle Formate | | Ausrichtung | Nur Hochformat | Hoch- + Querformat | | Kopf-/Fußzeilen | Nein | Ja | ### Fehlercodes | Status | Beschreibung | |--------|-------------| | 400 | Fehlende URL oder ungültiges HTML/JSON | | 401 | Nicht autorisiert — ungültiger API-Schlüssel | | 403 | Funktion erfordert bezahlten Plan | | 504 | Seiten-Ladezeitüberschreitung | | 500 | PDF-Erstellung fehlgeschlagen |