Page2Doc API NUR PRO

Programmgesteuerte Konvertierung von Webseiten über REST-API

Authentifizierung

Alle API-Anfragen müssen Ihren API-Schlüssel im Header X-API-Key enthalten:

X-API-Key: p2d_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxx

Endpunkte

URL zu Dokument konvertieren

Konvertieren Sie eine Webseiten-URL in PDF-, Word (DOCX)- oder Excel (XLSX)-Format.

Request Body (JSON)

Parameter	Typ	Erforderlich	Beschreibung
url	string	Ja	Vollständige URL der zu konvertierenden Seite (muss mit http:// oder https:// beginnen)
format	string	Ja	Ausgabeformat: pdf, docx oder xlsx
mode	string	Nein	Extraktionsmodus: full (Standard), article oder tables
clean	boolean	Nein	Entfernen Sie Anzeigen und Pop-ups (Standard: true)
wait	number	Nein	Wartezeit in Millisekunden vor dem Erfassen (Standard: 2000, max: 10000)

Beispiel-Anfrage (cURL)

curl -X POST https://page2doc.com/api/v1/convert \
  -H "Content-Type: application/json" \
  -H "X-API-Key: p2d_api_your_key_here" \
  -d '{
    "url": "https://example.com/article",
    "format": "pdf",
    "mode": "article",
    "clean": true
  }' \
  --output document.pdf

Beispiel-Anfrage (JavaScript/Node.js)

const response = await fetch('https://page2doc.com/api/v1/convert', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    url: 'https://example.com/article',
    format: 'docx',
    mode: 'article',
    clean: true
  })
});

const blob = await response.blob();
const buffer = Buffer.from(await blob.arrayBuffer());
fs.writeFileSync('output.docx', buffer);

Beispiel-Anfrage (Python)

import requests
import os

response = requests.post(
    'https://page2doc.com/api/v1/convert',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': os.environ['PAGE2DOC_API_KEY']
    },
    json={
        'url': 'https://example.com/article',
        'format': 'pdf',
        'mode': 'article',
        'clean': True
    }
)

with open('output.pdf', 'wb') as f:
    f.write(response.content)

Erfolgreiche Antwort

Status: 200 OK
Content-Type: application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document oder application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Der Antwortkörper enthält die binäre Dokumentdatei.

Fehler-Antworten

Status	Fehler	Beschreibung
401	Unauthorized	Ungültiger oder fehlender API-Schlüssel
403	Forbidden	Pro-Abonnement abgelaufen oder API-Schlüssel widerrufen
413	Payload Too Large	Seiteninhalt überschreitet Größenlimit (10 MB für Pro)
422	Unprocessable Entity	Ungültige URL oder nicht unterstütztes Format
429	Too Many Requests	Ratenlimit überschritten (500 Anfragen/Tag für Pro)
500	Internal Server Error	Konvertierung fehlgeschlagen oder Serverfehler

API-Schlüsselstatus überprüfen

Überprüfen Sie Ihren API-Schlüssel und sehen Sie sich die Nutzungsstatistiken an.

Beispiel-Anfrage

curl https://page2doc.com/api/v1/status \
  -H "X-API-Key: p2d_api_your_key_here"

Erfolgreiche Antwort

{
  "valid": true,
  "plan": "pro",
  "usage": {
    "today": 12,
    "month": 347,
    "limit": 500
  },
  "createdAt": "2025-02-15T10:30:00Z"
}

Ratenlimits

• Pro-Plan: 500 Anfragen pro Tag
• Burst-Limit: 10 Anfragen pro Minute
• Gleichzeitige Anfragen: Maximum 3 gleichzeitige Konvertierungen

Ratenlimit-Header sind in allen Antworten enthalten:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1708041600

Best Practices

• Speichern Sie konvertierte Dokumente wenn möglich zwischengespeichert, um API-Aufrufe zu reduzieren
• Verwenden Sie angemessene mode-Werte (article für Inhalt, tables für Daten)
• Implementieren Sie exponentielles Backoff für Ratenlimit (429) Fehler
• Setzen Sie angemessene wait Zeiten für JavaScript-intensive Seiten (3000-5000ms)
• Überwachen Sie Ihre Nutzung über den Endpunkt /api/v1/status
• Speichern Sie API-Schlüssel sicher (Umgebungsvariablen, Secret-Manager)

Support

Für API-Support, Ratenlimit-Erhöhungen oder benutzerdefinierte Integrationen kontaktieren Sie uns unter api@page2doc.com