Kann ich Ihre Druck-API verwenden, wenn ich kein Entwickler bin?
Um unsere Druck-API müssen Sie entweder selbst Entwickler sein oder Zugang zu einem Programmierer haben.
Wenn Sie Kontoinhaber sind, können Sie alternativ über unsere bestellen Manuelles Bestellformular oder CSV-Importer als auch über unsere Suite von E-Commerce-Integrationen mit Vertriebskanälen wie Etsy, Wix, WooCommerce und mehr.
Was ist der Unterschied zwischen Sandbox und Live?
Live ist unsere Produktionsumgebung. Bestellungen, die über die Live API erstellt werden, werden berechnet und nach der Erfüllung an unsere Druckereien weitergeleitet.
Sandbox ist eine separate Testumgebung, in der Bestellungen nicht berechnet oder ausgeführt werden. Sie ermöglicht es Ihnen, Ihre Integration zu erstellen und zu testen, ohne das Risiko, versehentlich eine Live-Bestellung zu erstellen.
Bei v5 verwenden Sandbox-API-Schlüssel das Sandbox_-Präfix, während Produktions-API-Schlüssel das Live_-Präfix verwenden.** **Beide werden an dasselbe gesendet Basis-URL. Das Präfix sagt v5, welche Umgebung verwendet werden soll.
Wir streben an, die Gleichheit zwischen Sandbox und Live zu wahren, aber gelegentlich kann es Unterschiede geben. Wo es Unterschiede gibt, bietet Live die aktuellsten und genauesten Informationen.
Wie finde ich meine API-Schlüssel?
Sobald Sie sich registriert haben, können Sie Ihre API-Schlüssel über Ihre Prodigi-Dashboard.
v5 verwendet separate API-Schlüssel für Sandbox und Live. Sandbox-Schlüssel verwenden das Sandbox_-Präfix, während Production Keys das Live_-Präfix verwenden.
Haben Sandbox und Live unterschiedliche API-Schlüssel?
Ja. Sandbox und Live verwenden separate API-Schlüssel, daher kann ein Sandbox-Schlüssel nicht mit der Live-API verwendet werden und umgekehrt.
Bei v5 verwenden Sandbox-Schlüssel das Sandbox_-Präfix, während Production Keys das Live_-Präfix verwenden. Dies erleichtert die Identifizierung der Umgebung, zu der ein Schlüssel gehört, und verringert das Risiko, einen Produktionsschlüssel beim Testen zu verwenden.
Warum sehe ich unterschiedliche Preise für Sandbox und Live?
Wir bemühen uns, die Datenparität zwischen Sandbox und Live aufrechtzuerhalten, aber sie ist nicht immer exakt. Falls es eine Diskrepanz gibt, bietet die Live-Umgebung die aktuellsten und genauesten Preisinformationen.
Wenn Sie einen Preisunterschied bemerken, schreiben Sie uns bitte eine E-Mail an support@prodigi.com und wir werden ermitteln.
Wie setze ich meine API-Schlüssel zurück?
Du kannst deine API-Schlüssel über deine verwalten und neu generieren Prodigi-Dashboard.
Sandbox und Live verwenden separate API-Schlüssel, also stelle sicher, dass du den Schlüssel für die richtige Umgebung neu generierst.
Welche Bilddateitypen akzeptiert die API?
Unser Druck-API akzeptiert derzeit nur JPG-, PNG- oder PDF-Dateien. Das benötigte Bild ist jedoch oft produktspezifisch. Die meisten Produkte benötigen entweder JPG oder PNG.
Was passiert, wenn mein Bild nicht in den Produktdruckbereich passt?
Wenn Ihr Bild standardmäßig nicht zur Produktgröße passt, schneiden wir Ihr Bild zentral zu. Wir drucken das Bild so groß wie möglich und entfernen die oberen/unten oder linken/rechten Teile des Bildes, die über den Druckbereich hinausgehen. Sie können jedoch auch einen Größenparameter angeben, um dieses Verhalten zu ändern:
Crop (Standard)
Ihr Bild wird zentriert und beschnitten, sodass es genau zum Seitenverhältnis (Höhe geteilt durch Breite) der Druckfläche Ihres ausgewählten Produkts passt. Ihr Bild bedeckt den gesamten Produktdruckbereich.
ShrinktoFit
Dein Bild wird so verkleinert, dass es den gesamten Druckbereich des Produkts ausfüllt. Wenn das Seitenverhältnis deines Bildes sich von dem des Druckbereichs unterscheidet, wird dein Bild gestreckt oder zusammengedrückt, um zu passen.
Rotation
Unser Druck-API dreht Ihre Bilder automatisch so, dass sie so wenig wie möglich angepasst werden müssen, um zur Produktgröße zu passen. Wenn Sie zum Beispiel ein 10x15-Foto erstellen und ein Bild hochladen, das 4500x3000px groß ist, drehen wir es so, dass es 3000x4500px hat und somit perfekt zum Foto passt.
Wie kann ich mehrere Bilder als Charge zu einer Bestellung hinzufügen?
Sie können mehrere Bilder zu einer Bestellung hinzufügen, indem Sie mehrere Artikel in Ihre Bestellanfrage aufnehmen, wobei jeder Artikel die Details für das jeweilige Produkt und Kunstwerk enthält.
Das funktioniert genauso wie v4 – füge einfach für jedes Bild, das du in die Reihenfolge einfügen möchtest, ein Element hinzu.
Mit v5 kannst du das auch neue Artikel zu einer bestehenden Entwurfsbestellung hinzufügen Verwendung des Endpunkts “Bestellung hinzufügen”. Das bedeutet, dass Sie eine Bestellung schrittweise aufbauen können, bevor Sie sie zur Erfüllung einreichen.
Was ist ein Asset?
Ein Asset ist das Kunstwerk, das auf einem bestimmten Teil eines Produkts gedruckt wird. Einige Produkte, wie zum Beispiel Drucke und Plakate, erfordern ein einzelnes Asset, während andere mehrere Assets haben können.
Mit v5 kann das Artwork auch direkt in Prodigi hochgeladen oder von einer URL importiert und dann in verschiedenen Bestellungen wiederverwendet werden. Man kann ein Asset vor der Bestellung mit einer ausgewählten Katalogvariante (SKU) und einem Druckbereich vergleichen, wobei v5 mögliche Auflösungs- und Seitenverhältnisprobleme anzeigt.
Welche Eigenschaften hat ein Produkt?
Du kannst die v5 Katalog-Endpunkte um Produktinformationen abzurufen, einschließlich der für ein Produkt verfügbaren Attribute und Optionen.
Wie validiere ich eine Bestellung in der Druck-API?
Der Validierungsprozess hängt davon ab, welche Version unserer Print-API Sie verwenden.
Mit v5 kannst du eine Bestellung als Entwurf erstellen, Änderungen vornehmen und gemeldete Validierungsprobleme beheben, bevor du sie zur Erfüllung einreichst.
Wenn eine Anfrage die Validierung fehlschlägt, liefert die API Details des Problems, einschließlich der Felder, die Probleme verursachen, wo zutreffend.
Du kannst auch einen Sandbox-API-Schlüssel verwenden, um deinen Bestellerstellungsprozess zu testen, ohne Live-Fulfillment-Bestellungen aufzugeben.
Wie gebe ich eine Bestellung in der Print-API auf?
Mit v5 unserer Druck-API können Bestellungen als Entwürfe erstellt werden, sodass man eine Bestellung erstellen und ändern kann, bevor man sie zur Erfüllung einreicht.
Sobald die Bestellung fertig ist, kannst du sie über die API einreichen. Wenn du den in v4 verwendeten Create-and-File-Flow bevorzugst, kannst du beim Erstellen einer Bestellung submit: true hinzufügen, um sie in einer einzigen Anfrage zu erstellen und einzureichen.
Wenn du Prodigi’s benutzt Bestellpause-Funktion wird eine abgegebene Bestellung in dein konfiguriertes Pausenfenster aufgenommen, bevor sie in die Produktion freigegeben wird. Mit v5 kannst du über die API auf pausierte Bestellungen zugreifen und eine einzelne Bestellung wieder aufnehmen, wenn du bereit bist, in Produktion zu gehen.
Um Ihren Bestellerstellungs- und Abgabeprozess zu testen, ohne Bestellungen zu erfüllen oder abzubuchen, nutzen Sie die Sandbox-Umgebung.
Für technische Details, Erkunde die V5-Dokumentation.
Wie kann ich herausfinden, was meine Bestellung kosten wird?
Mit Version 5 können Sie vor der Bestellung ein Angebot anfordern, einschließlich Produktpreis, Versandkosten und Steuern.
Sie können diese Kosten einzeln abholen oder ein kombiniertes Bestellangebot anfordern, das Ihnen vor der Bestellung einen klareren Überblick über die Gesamtkosten gibt.
Wie bestelle ich ein Fotobuch über die API?
Beim Platzieren eines Fotobuch Befehl über die Druck-API müssen Sie die gesamte Seitenzahl des Buches in Ihre Bestellung eingeben, um eine genaue Preisgestaltung und eine reibungslose Auftragsbearbeitung zu gewährleisten.
Was passiert, wenn ich die Seitenanzahl nicht angebe?
Wenn Sie keine Seitenanzahl angeben, gehen wir davon aus, dass für zusätzliche Seiten keine zusätzlichen Gebühren anfallen. Wenn unser System jedoch eine Diskrepanz zwischen der tatsächlichen Seitenzahl und dem übermittelten Wert feststellt, wird die Bestellung zurückgestellt.
Wie kann ich eine Bestellung lösen, die aufgrund einer Seitenanzahl-Diskrepanz in die Warteschleife gestellt wurde?
Wenn Ihre Bestellung aufgrund einer Seitenanzahl nicht übereinstimmt, benachrichtigen wir Sie. Sie erhalten eine Anfrage, die Bestellung mit der korrekten Seitenzahl erneut einzureichen.
Um das Problem zu lösen, stellen Sie bitte sicher, dass Ihre Bestellung einen Wert für die PageCount-Eigenschaft auf der Order-Item-Asset-Entität enthält. Spezifische Details zur erforderlichen Nutzlast finden Sie in unserer API-Dokumentation: Prodigi API-Referenz – Orderobjekt-Asset.
Was sind die Regeln für die Seitenzählung?
Im Grundpreis sind die ersten 24 Seiten enthalten.
Für Bücher mit mehr als 24 Seiten:
- Wenn die Anzahl der eingereichten Seiten mit der tatsächlichen Anzahl übereinstimmt, wird die Bestellung wie gewohnt verarbeitet
- Wenn die Seitenanzahl nicht übereinstimmt, wird die Bestellung zurückgestellt und Sie müssen sie korrigieren und erneut einreichen
Was ist der Unterschied zwischen Prodigi API v4 und v5?
v5 gibt dir viel mehr Kontrolle über den gesamten Bestellzyklus über unsere Druck-API.
Sie können Entwurfsaufträge erstellen und ändern, pausierte Bestellungen abrufen und diese fortsetzen, Bestellungen vor der Produktion stornieren, Artikel hinzufügen oder entfernen, Mengen und Lieferdetails ändern, Probleme ansprechen und auf Bestellhistorie und Versandinformationen zugreifen.
v5 führt außerdem eine dedizierte Quote-Funktionalität, verwaltete Kunstwerke, interaktive Dokumentation sowie separate Sandbox- und Live-Umgebungen ein.
Benutzt du bereits v4? Es besteht kein unmittelbarer Grund zur Migration. Erfahre mehr darüber, was sich geändert hat in unser API-v5-Startpost, oder Erkunden Sie die v5-Dokumentation für technische Details.
Muss ich von v4 zu v5 migrieren?
Nein. Wenn du bereits eine funktionierende v4-Integration hast, ist keine sofortige Aktion erforderlich.
Wir unterstützen v4 weiterhin über eine lange Übergangsphase, sodass Sie entscheiden können, wann der Wechsel zu v5 für Ihr Unternehmen sinnvoll ist. Zum Start gibt es keine erzwungene Migrationsfrist.
Wir haben auch mehrere Teile von v4 vertraut gehalten, um das Überqueren zu erleichtern. Bestehende Prodigi-SKUs funktionieren weiterhin, Kopien werden als veralteter Alias für Quantity und submit: true akzeptiert, um den Create-and-Send-Flow von v4 nachzubilden.
Lesen Sie unser v4 zu v5 Migrationsleitfaden für eine technische Aufschlüsselung dessen, was sich geändert hat, und wie man seine Integration migriert.
Kann ich über die Druck-API auf pausierte Bestellungen zugreifen?
Ja. Mit v5 kannst du Bestellungen über die API aufrufen, solange sie sich innerhalb deines konfigurierten Pausefensters befinden.
Das bedeutet, dass deine Integration mit einer pausierten Bestellung interagieren kann, bevor sie in Produktion geht. Wenn du sicher bist, dass alles korrekt ist, kannst du eine einzelne Bestellung über die API fortsetzen und frühzeitig in die Produktion gehen.
Erfahren Sie mehr über unser Befehlspause-Funktion.
Kann ich eine Bestellung über die Druck-API bearbeiten?
Ja. V5 gibt dir mehr Kontrolle über Bestellungen, bevor sie in Produktion gehen.
Du kannst eine Bestellung als Entwurf erstellen, dann Artikel hinzufügen oder entfernen, Mengen und Größen ändern und die Lieferdetails aktualisieren, bevor du sie zur Erfüllung einreichst.
Sobald eine Bestellung eingereicht wurde, können nur die Lieferdetails geändert werden, und das nur bevor sie in die Produktion geht. Wir empfehlen daher, weitere Änderungen vorzunehmen, bevor Sie Ihre Bestellung abgeben.
Kann ich eine Bestellung über die Print-API stornieren?
Ja. V5 erlaubt es dir, berechtigte Bestellungen über die API zu stornieren, bevor sie in Produktion gehen.
Sobald eine Bestellung in die Produktion gegangen ist, ist eine Stornierung möglicherweise nicht mehr möglich.
Kann ich den Verlauf und die Sendungen einer Bestellung über die Druck-API einsehen?
Ja. V5 gibt Ihnen Zugriff auf den aktuellen Status und die chronologische Historie einer Bestellung sowie auf die Sendungen, einschließlich Versand- und Sendungsverfolgungsinformationen, sofern verfügbar.
Das verschafft Ihrer Integration eine größere Transparenz darüber, was mit einer Bestellung passiert ist, ohne sie separat überprüfen zu müssen. Prodigi-Dashboard.
Kann ich ein Problem mit einer Bestellung über die Druck-API melden?
Ja. Mit Version 5 kannst du direkt über die API ein Problem gegen eine Bestellung erheben.
Dazu gehören Probleme im Zusammenhang mit beschädigten, falschen oder fehlenden Artikeln, Druckqualität oder Versand, sodass ein größerer Teil Ihres Postorder-Workflows durch Ihre Integration verwaltet werden kann.
Kann ich Kunstwerke über die Print-API hochladen?
Ja. v5 erlaubt es dir, Artwork direkt in Prodigi hochzuladen oder von einer URL zu importieren, anstatt sich ausschließlich auf extern gehostete Artwork-URLs zu verlassen.
Direkte Uploads unterstützen Dateien bis zu 100 MB, und hochgeladene Kunstwerke können über Bestellungen hinweg wiederverwendet werden. Sie können ein Asset auch vor der Bestellung mit einer ausgewählten Katalogvariante (SKU) und dem Druckbereich vergleichen, wobei Version 5 mögliche Auflösungs- und Seitenverhältnisprobleme anzeigt.
Was passiert, wenn ich eine Bestellung erneut anfordern muss?
v5 unterstützt einen Idempotency-Key-Header beim Erstellen einer Ordnung.
Wenn deine Integration eine Bestellung erneut versuchen muss, schützt die Verwendung desselben Idempotenzschlüssels davor, dieselbe Bestellung mehrmals versehentlich zu erstellen.
Idempotenz gilt für die Erstellung von Bestellungen, daher finden Sie in der v5-Dokumentation Details darüber, wie und wann ein Idempotenz-Schlüssel verwendet werden sollte.
Gibt es ein Rate-Limit für die Prodigi API v5?
Ja. Die IPv5-API-Schlüssel sind derzeit auf 1.000 Anfragen pro Stunde pro Schlüssel begrenzt.
Standard-Rate-Limit-Header sind in API-Antworten enthalten, um Ihrer Integration das Verständnis und die Verwaltung der Nutzung zu erleichtern.
Unterstützt Prodigi API v5 Webhooks?
Webhook-Abonnements sind derzeit in Version 5 nicht verfügbar.
Callbacks pro Bestellung werden unterstützt und im bestehenden v4-Callback-Format ausgeliefert, sodass bestehende Integrationen weiterhin Bestellupdates erhalten, während sie auf v5 umgestellt werden.