Zum Inhalt springen
Für Entwickler

Treib dein Business mit unserer API an.

Verbinde deine Plattform direkt mit unserer Fertigungs- und Fulfillment-Infrastruktur. API-Schlüssel sind im Pro-Tarif auf app.tullunprint.com enthalten – ohne Antrag.

So funktioniert der Zugang

Melde dich in deinem Verkäuferkonto an und öffne die API-Seite. Erstelle einen Schlüssel für jedes System, das mit uns spricht, und hinterlege die URL, die wir aufrufen sollen, wenn sich eine Bestellung ändert. Die vollständige Referenz – Basis-URL, jeder Endpunkt, eine Beispielanfrage – steht auf derselben Seite.

  • Produktkatalog mit deinen Preisen
  • Deine gespeicherten Designs
  • Bestellungen aufgeben
  • Bestellstatus
  • Sendungsverfolgung
  • Webhooks bei jeder Änderung
  • Ein Schlüssel pro System
  • Automatisiertes Fulfillment
app.tullunprint.com/merchant/api In deinem Konto
1
AnmeldenAPI-Schlüssel sind im Pro-Tarif enthalten. Keine separate Entwickler-Registrierung.
2
Schlüssel erstellenEin Schlüssel pro System, das mit uns spricht – so legt das Sperren eines Schlüssels nie ein anderes System lahm.
3
Webhook hinzufügenWir rufen deine URL auf, wenn sich der Status einer Bestellung ändert – mit denselben Begriffen wie die Bestellseite.
Was die API abdeckt
  • GET  /catalogAlles, was wir drucken, mit deinen Preisen
  • GET  /designsDeine gespeicherten Designs und ihre Tokens
  • GET  /ordersDeine Bestellungen, neueste zuerst
  • GET  /orders/{id}Eine Bestellung: Status, Artikel, Sendungsverfolgung
  • POST /ordersEine Bestellung aus einem gespeicherten Design aufgeben
  • POST /webhooksÜber Änderungen an Bestellungen informiert werden
  • GET  /webhooksDie URLs, die du registriert hast
  • DELETE /webhooks/{id}Eine davon stoppen
JSON rein und raus · Preise kommen immer aus deinem Katalog, nie aus der Anfrage · Designs entstehen im Designer und werden per Token verwendet
Was du bauen kannst

Alles, was das Dashboard kann, per Skript.

Katalog lesen

Jede Hülle, die wir drucken, und jedes Gerät, für das sie passt – mit deinem Rabatt bereits eingerechnet.

Deine Designs verwenden

Designs werden einmal im Designer erstellt und per Token referenziert – keine Motiv-Uploads in der Anfrage.

Bestellungen aufgeben und verfolgen

Sende eine Bestellung mit Empfänger und lies dann Status, Artikel und Sendungsverfolgung, während sie unterwegs ist.

Benachrichtigt statt abgefragt

Webhooks melden sich bei jeder Änderung einer Bestellung, so bleibt dein System auf dem Laufenden, ohne nachzufragen.

Gut zu wissen

Ein paar Dinge, bei denen die API streng ist.

Schlüssel werden nur einmal angezeigt

Ein neuer Schlüssel wird nur ein einziges Mal angezeigt; wir speichern nur einen Fingerabdruck. Sperren und neu ausstellen kannst du auf derselben Seite.

Preise kommen aus deinem Katalog

Eine Anfrage legt nie einen Preis fest. Du zahlst, was dein Katalog im Moment der Bestellung sagt.

Überall dieselben Begriffe

Die Bestellstatus heißen in der API, in den Webhooks und auf der Bestellseite gleich – „Being made“, „On its way“ –, damit nichts umgedeutet werden muss.

Ein Ereignis, klar und einfach

Jede Statusänderung sendet order.updated an deine https-URL – mit der Bestellung, ihrem Status, der Sendungsnummer, sobald es eine gibt, und der Uhrzeit.

Spielraum

Bis zu 120 Anfragen pro Minute und Schlüssel und 30 neue Bestellungen pro Minute. Schlüssel funktionieren weiter, wenn du den Tarif wechselst; neue Schlüssel brauchen Pro.

Baue auf unserer Produktionsinfrastruktur auf.

Melde dich in deinem Verkäuferkonto an, erstelle einen Schlüssel und starte noch heute mit der Integration.