REST API · MCP

Dein Workflow. Echtes Papier.

Nutze REST für deine Software oder MCP für deinen Assistenten. Beide verwenden dein Guthaben, dieselben Preise und deine Zugangslimits.

Zugang erstellen OpenAPI JSON

Zugang & Bezahlung

Sende deinen persönlichen Zugangsschlüssel als Authorization: Bearer. Gültigkeit, Widerruf sowie Auftrags- und Tageslimits gelten auch für REST. Lade im Konto Guthaben auf oder fordere nach Freigabe von Vorschau und Preis einen Bezahl-Link an.

https://die-internetausdrucker.de/v1

Preisschätzung ohne Upload

Kennst du die Druckseitenzahl bereits? Frage den Preis direkt ab – inklusive Versand und Umsatzsteuer. Gib die vollständige Seitenzahl einschließlich Adressblatt an (eine Seite bei Simplex, zwei bei Duplex). Das aufbereitete Dokument erhält anschließend sein verbindliches Angebot.

curl -X POST https://die-internetausdrucker.de/v1/price \
  -H 'Authorization: Bearer YOUR_ACCESS_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"letter":{"specification":{"pages":402,"color":"1","mode":"duplex","shipping":"national"}}}'

Endpunkte & Ablauf

Endpoint	Funktion
`GET /v1/balance`	Guthaben und Limits
`GET/POST /v1/price`	Preisschätzung anhand der Seitenzahl
`POST /v1/uploads`	PDF/Office-Upload vorbereiten, Datei anschließend per PUT übertragen
`POST /v1/printjobs`	Base64-PDF als Entwurf zur Aufbereitung übertragen
`GET /v1/printjobs`	Eigene Dokumente auflisten; 50 pro Seite
`GET /v1/printjobs/{id}`	Status der Aufbereitung und Bestellung
`POST /v1/printjobs/{id}/delivery`	Lieferadresse ergänzen, neue Dokument-ID erhalten
`GET/POST /v1/printjobs/{id}/quote`	Verbindlichen Preis der fertigen Druckdatei abrufen
`POST /v1/printjobs/{id}/submit`	PDF-Hash und Preis ausdrücklich bestätigen; mit Guthaben oder Checkout bestellen

Kompatibilität & Grenzen

Die Endpunkte balance, price und printjobs verwenden die bekannte letter/specification-Struktur. Unterstützt wird ein dokumentierter Teilumfang mit ausdrücklicher Vorschau und Freigabe, kein vollständiger Ersatz aller Anbieteroptionen. IDs sind Zeichenketten. Unterstützt sind nationaler A4-Druck, S/W oder Farbe, Simplex/Duplex und automatische Umschlag-/Paketwahl. Einschreiben, Ausland, Terminversand, erzwungenes C4, Serienbriefe, Hintergründe, Anhänge, Zahlscheine und Stornierung werden derzeit ausdrücklich abgewiesen.

Standardmodus ist test: keine kostenpflichtigen Bestellungen. Zum Bestellen sind auth.mode=live, quote_id, preview_confirmed=true, confirmed_pdf_sha256, confirmed_amount_cents, idempotency_key und payment (wallet oder checkout) sowie ein freigeschalteter Live-Shop erforderlich. Uploads bis 100 MiB; Base64-PDF und fertige Druck-PDF bis 50 MB. Bis 120 Anfragen/Minute pro Zugang; gemeinsame MCP-Aktionslimits gelten zusätzlich.

Alternativ: auth.apiKey = SHA-256-Hexwert deines Zugangsschlüssels und auth.apiSecret = der Zugangsschlüssel. Zugangsdaten niemals in einer URL übertragen.