Direkt zum Hauptinhalt

FAQ: Druck-API

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. Alle Bestellungen, die über die Live-API (api.prodigi.com) erstellt werden, werden wie erwartet in Rechnung gestellt und an die Druckereien weitergeleitet.

Auf der anderen Seite berechnet Sandbox (api.sandbox.prodigi.com) keine Bestellungen und führt keine Bestellungen aus. Sein Hauptzweck besteht darin, dass Händler die API auf halbwegs reale Weise ausprobieren können, ohne das Risiko, belastet zu werden oder versehentlich etwas zu bestellen.

Wir halten die Sandbox-Umgebung genauso auf dem neuesten Stand wie unsere Live-Umgebung, sodass Sie immer die neuesten Funktionen auf beiden sehen.

Wie finde ich meine API-Schlüssel?

Sobald Sie sich registriert haben, können Sie sich entweder bei der Live- oder der Sandbox-API mit denselben Anmeldedaten anmelden, die Sie zum Erstellen Ihres Kontos verwendet haben.

Sie können Ihre API-Schlüssel auch jederzeit einsehen, indem Sie zu Ihrem navigieren Prodigi-Dashboard, klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke des Bildschirms und klicken Sie auf die Schaltfläche “API-Schlüssel anzeigen”.

Haben Sandbox und Live unterschiedliche API-Schlüssel?

Ja. Sandbox-API-Schlüssel können nicht in der Live-API verwendet werden und umgekehrt.

Warum sehe ich unterschiedliche Preise für Sandbox und Live?

Obwohl wir alle Anstrengungen unternehmen, um die Datenparität zwischen diesen Umgebungen zu gewährleisten, ist dies nicht immer genau. Wenn es eine Diskrepanz gibt, verfügt die Live-Umgebung immer über die aktuellsten und genauesten Informationen.

Sollten Sie doch einmal einen Preisunterschied feststellen, bitte in Kontakt kommen bei uns und wir werden die Daten entsprechend ändern.

Wie setze ich meine API-Schlüssel zurück?

Um Ihre API-Schlüssel zurückzusetzen, gehen Sie wie folgt vor: einloggen in Ihrem Dashboard, klicken Sie auf das Zahnradsymbol und wählen Sie “API-Schlüssel anzeigen”. Sie haben dann die Möglichkeit, Ihre API-Schlüssel neu zu generieren. Sie müssen dies sowohl für Live- als auch für Sandbox-Umgebungen tun.

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 nicht zur Produktgröße passt, schneiden wir es standardmäßig zentral zu. Wir drucken das Bild so groß wie möglich, wobei wir die oberen/unteren oder linken/rechten Teile des Bildes entfernen, die über den Druckbereich hinausragen. Sie können jedoch auch einen Größenparameter angeben, um dieses Verhalten zu ändern:

Crop (Standard)

Ihr Bild wird zentriert und so beschnitten, dass es genau dem Seitenverhältnis (Höhe geteilt durch Breite) des Druckbereichs Ihres ausgewählten Produkts entspricht. Ihr Bild deckt den gesamten Produktdruckbereich ab.

ShrinktoFit

Die Größe Ihres Bildes wird so verändert, dass es den Druckbereich des Produkts vollständig ausfüllt. Wenn das Seitenverhältnis Ihres Bildes von dem des Druckbereichs abweicht, wird Ihr Bild gestreckt oder gequetscht, damit es passt.

Drehung

Unser Druck-API dreht Ihre Bilder automatisch, sodass sie so wenig wie möglich in der Größe geändert werden müssen, um sie an die Produktgröße anzupassen. Wenn Sie beispielsweise ein 10x15-Foto erstellen und ein Bild mit einer Größe von 4500 x 3000 Pixeln hochladen, drehen wir es so, dass es 3000 x 4500 Pixel groß ist und somit perfekt zum Foto passt.

Wie füge ich mehrere Bilder als Stapel zu einer Bestellung hinzu?

Um einer Bestellung mehrere Bilder als Stapel hinzuzufügen, müssen Sie ein JSON-Array von Auftragspositionen senden. Zum Beispiel:

[ ` { ` ‘ “type”:”4x6”,’ ‘ “url”:”https://…”’ ` }, { ` ‘ “type”:”5x7”,’ ‘ “url”:”https://…”’ ` } ]`

Was ist ein Vermögenswert?

Ein Asset bezieht sich auf das Bild, das auf einen bestimmten Teil des Produkts gedruckt wird. Einige Produkte, wie z. B. Drucke und Poster, haben ein einzelnes Asset, während andere, wie bestimmte T-Shirts, mehrere Assets haben können.

Welche Eigenschaften hat ein Produkt?

Unser Druck-API verfügt über einen Endpunkt, der alle Produktinformationen nach Produkt-SKU zurückgibt, einschließlich gültiger Attribute.

Wie validiere ich eine Bestellung in der Druck-API?

Auftragserstellung in unserem Druck-API ist ein einstufiger Prozess. Wir validieren Ihre Bestellung bei der Erstellung, und wenn sie fehlschlägt, geben wir eine Rückmeldung über den Fehler zurück und die Bestellung wird nicht erstellt. Wenn die Bestellung gültig ist, wird sie erstellt, und es wird eine Antwort von 200 zurückgegeben.

Wenn Sie Ihren Auftragserstellungsprozess testen möchten, können Sie dies in der Sandbox-Umgebung tun, in der Bestellungen nicht verarbeitet oder belastet werden.

Wie kann ich eine Bestellung in der print API aufgeben?

Es sei denn, Sie entscheiden sich dafür, ein Fenster zum Bearbeiten von Bestellungen über unsere Funktion zum Pausieren der Bestellung wird jede gültige Bestellung, die Sie erstellen, sofort übermittelt.

Um Ihren Auftragserstellungsprozess zu testen, ohne Bestellungen tatsächlich zu verarbeiten oder zu belasten, können Sie die Sandbox-Umgebung verwenden.

Wie kann ich herausfinden, was meine Bestellung kosten wird?

Unser Druck-API über einen ‘Quote’-Endpunkt verfügt, der einen Preis für Ihre Bestellung generiert, ohne ihn zu erstellen. Der Endpunkt “Angebot” akzeptiert Produkt-SKUs, ein Zielland und optional eine Versandart. Anschließend wird eine Preisaufschlüsselung für Ihre Bestellung zurückgegeben.