PrintHub REST API — Direktzugriff für volle Flexibilität
Keine Plattform, kein Plugin — nur pure API. Perfekt für eigene Shops, Mobile-Apps, Headless-Commerce oder ungewöhnliche Systeme.
Überblick
Unsere öffentliche REST API ist das Fundament aller PrintHub-Integrationen — auch unsere Shopify-App ruft intern dieselben Endpoints auf. Wenn du einen eigenen Shop, eine B2B-Plattform, ein ERP-System oder eine Mobile-App betreibst, sprichst du direkt mit uns: JSON rein, Druckauftrag raus.
Warum REST API mit PrintHub?
Maximale Flexibilität
Keine Annahmen über deine Plattform. Egal ob Laravel, Next.js, Ruby on Rails, Odoo oder SAP — wenn du HTTP sprechen kannst, sprichst du mit uns.
Sandbox-Testing ohne Risiko
Mit pk_test_-Keys simulierst du beliebige Szenarien — Bestellungen werden akzeptiert, validiert und in den Sandbox-Logs angezeigt, aber nie produziert.
Webhooks für alle relevanten Events
order.submitted, order.shipped, order.error — pushen wir HMAC-signiert an deine URL. Keine Polling-Loops nötig.
Bulk Orders für Events und Seasons
Bis zu 20 Bestellungen in einem POST — perfekt für Black-Friday-Spitzen, Event-Tickets oder Mitarbeiter-Swag.
In Stunden bis 1 Tag einsatzbereit
Schritt für Schritt von Null zur ersten automatisierten Bestellung.
- 01
Account erstellen und Keys abholen
Registriere dich im Partner-Dashboard. Du bekommst sofort einen Sandbox- (pk_test_) und einen Live-Key (pk_live_).
- 02
Sandbox-Test mit curl
Ein einzelner POST /api/orders mit pk_test_ bestätigt, dass deine Integration prinzipiell läuft. Du siehst das Ergebnis in den Sandbox-Logs.
- 03
Produktionscode bauen
Baue deinen Mapping-Layer (interne Produkt-IDs → PrintHub-Produkt-IDs), Error-Handling und Idempotenz-Keys. Siehe Code-Beispiel unten.
- 04
Webhook-URL registrieren
Im Dashboard trägst du deine öffentliche HTTPS-URL ein. Wir senden alle Status-Updates dorthin — signiert mit HMAC-SHA256.
- 05
Wallet aufladen und live gehen
Pro Bestellung wird dein PrintHub-Wallet belastet. Lade es per SEPA oder Kreditkarte auf und wechsle auf pk_live_.
Was diese Integration kann
- REST API mit JSON-Payloads
- Live- und Sandbox-Keys (pk_live_ / pk_test_)
- Webhooks: order.submitted, order.shipped, order.error
- Bulk: bis zu 20 Orders pro Request
- Rate Limit: 60 Requests/Minute, mit 429-Backoff-Hinweisen
- HMAC-SHA256-Signatur für Webhook-Verifikation
- Idempotenz-Keys für sichere Retries
Direkt loslegen
Minimale Bestellung mit fetch — derselbe Payload funktioniert auch in Node.js, Deno, Bun oder im Browser.
// Node.js 18+ / Deno / Bun / Cloudflare Workers / Browser
// Erste Bestellung anlegen — mit Sandbox-Key testen, dann pk_live_ nutzen
const response = await fetch('https://api.print-hub.com/api/orders', {
method: 'POST',
headers: {
'X-API-Key': 'pk_test_xxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
external_id: 'order-2026-0001',
customer: {
name: 'Maria Musterfrau',
street: 'Musterstraße 12',
zip: '20095',
city: 'Hamburg',
country: 'DE',
email: 'maria@example.com',
},
items: [
{
product_id: 'tasse-weiss-330ml',
quantity: 2,
properties: {
engraving: 'Team Hamburg 2026',
design_url: 'https://cdn.example.com/design.png',
},
},
],
}),
});
const order = await response.json();
console.log(order);
// {
// order_id: 'ph_ord_8fJ2kL',
// status: 'submitted',
// estimated_shipping: '2026-04-15'
// }Was Partner uns oft fragen
Wie authentifiziere ich mich?
Welche Rate Limits gelten?
Wo finde ich die vollständige Dokumentation?
Werden Sandbox-Bestellungen produziert?
Brauche ich vorab einen Wallet-Balance?
Bereit, REST API mit PrintHub zu verbinden?
Wir besprechen in einem 30-Minuten-Call dein Setup, Sortiment und Volumen — und schicken dich mit konkretem Fahrplan raus.