Wie können wir Ihnen helfen?
Vielen Dank! Ihr Beitrag ist eingegangen!
Huch! Beim Absenden des Formulars ist etwas schief gelaufen.
Die Print-on-Demand-Plattform von Peecho bietet flexible Lösungen für den Druck hochwertiger Produkte. Sie können eine Bestellung auf zwei Arten aufgeben: über Ihre App oder Plattform mit der Peecho Print API oder über die gehostete Kasse von Peecho.
Der Prozess beginnt, wenn Ihr Kunde einen Kauf auf Ihrer App oder Plattform abschließt. Sie ziehen die Zahlung über Ihr eigenes Checkout-System ein. Durch die Integration der Peecho Print API in Ihren Bestellablauf automatisieren Sie die Erstellung der Bestellung, die Bezahlung und die Übergabe an die Produktion.
Über die API können Sie auch Angebote anfordern, Auftragsdetails aktualisieren, den Status verfolgen und vieles mehr.
Um die gehostete Kasse von Peecho zu nutzen, erstellen Sie zunächst eine Produktliste in Ihrem Dashboard. Dadurch wird ein Link zur Kasse generiert, den Sie direkt an Ihre Kunden weiterleiten oder als Schaltfläche "Drucken kaufen" auf Ihrer Website einbetten können.
Um eine Bestellung über unsere API v3 aufzugeben, gehen Sie folgendermaßen vor:
Wir werden jeden dieser Schritte am Beispiel eines gebundenen Buches durchgehen.
Erstellen Sie zunächst ein Konto in der Testumgebung, um Ihre API-Anmeldedaten zu erhalten. Sie finden Ihren API-Schlüssel im Test-Dashboard unter Einstellungen > API.
Beachten Sie, dass productIds und apiKeys aus der Produktionsumgebung nicht in der Testumgebung funktionieren und umgekehrt.
Bevor Sie eine Bestellung aufgeben, müssen Sie Ihre Geschäftsadresse angeben. Dies ist wichtig, weil die auf jede Bestellung erhobene Steuer zum Teil vom Standort Ihres Unternehmens abhängt.
Für Tests können Sie Scheindaten verwenden. Um Ihre Daten hinzuzufügen, gehen Sie zu Dashboard > Einstellungen > API > Unternehmensdaten.
Für dieses Beispiel nehmen wir eines unserer beliebtesten Produkte: ein A4-Hardcover-Buch im Querformat (21 x 29,7 cm).
Jedes Konto hat eine eindeutige Produkt-ID. Um Ihre zu finden, gehen Sie zu Dashboard > Einstellungen > Produkte > Bücher > Produkt-ID.
Wenn Sie die API mit einem anderen Produkt testen möchten, können Sie es auf derselben Seite finden und auswählen. Vergewissern Sie sich nur, dass Sie eine Datei haben, die den Spezifikationen des Produkts entspricht.
Für jedes Produkt ist ein bestimmter Dateiaufbau erforderlich. Für die meisten Produkte wird eine Auflösung von 300 DPI empfohlen, und die Dateien müssen im RGB-Farbprofil eingereicht werden. Detaillierte Dateirichtlinien finden Sie im Peecho Help Center.
In diesem Beispiel verwenden wir das A4-Fotobuch im Querformat, das 21 x 29,7 cm misst. Für dieses Produkt sind mindestens 24 Seiten erforderlich, Ihre Datei muss also mindestens so lang sein.
Die Peecho-API akzeptiert zwei Dateikonfigurationen für Bücher:
Erstellen Sie eine einzelne PDF-Datei, die das vordere Deckblatt, die Inhaltsseiten und das hintere Deckblatt enthält, die in dieser Reihenfolge als Einzelseiten angeordnet sind. Die erste Seite wird als vorderes Deckblatt und die letzte Seite als hinteres Deckblatt gedruckt. Standardmäßig bleibt der Buchrücken leer.
Wenn Sie eine Wirbelsäule einfügen möchten, gibt es zwei Möglichkeiten:
Bei dieser Konfiguration stellen Sie zwei Dateien bereit:
Dieser Ansatz ist ideal für Umschlagdesigns. Wenn Sie diese Einstellung verwenden, müssen Sie die Rückenbreite manuell mit dem Endpunkt Rückenbreite ermitteln berechnen.
Wenn Sie keine Datei zum Testen haben, können Sie die Peecho-Beispieldatei verwenden, die sowohl Cover als auch Inhalt enthält. Wenn Sie einen benutzerdefinierten Buchrücken mit der Beispieldatei testen möchten, können Sie die PDF-Datei mit dem benutzerdefinierten Buchrücken verwenden.
Nachdem Sie nun ein Produkt ausgewählt und Ihre Datei vorbereitet haben, können Sie die Bestellung erstellen, indem Sie eine POST-Anfrage an folgende Adresse senden:
https://test.www.peecho.com/rest/v3/orders/
Für die Erstellung einer Bestellung ist ein einziger API-Aufruf erforderlich, der alle relevanten Details enthält. Stellen Sie sicher, dass Sie den MerchantKey und die productId aus Ihrem Testkonto verwenden - die Anmeldedaten aus der Produktion funktionieren in der Testumgebung nicht.
Sie können einen Auftrag auf zwei Arten erstellen:
Geben Sie die Datei-URL im file_details-Objekt an.
Lassen Sie die Parameter file_details bei der Auftragserstellung leer. Sie werden die Dateien später mit dem Endpunkt Set files asynchron bereitstellen.
Sobald der Auftrag erstellt ist, erscheint er in Ihrem Dashboard im Status "Offen". Sie benötigen die orderId, um eine Zahlung zu tätigen und den Auftrag im Rahmen des Auftragsablaufs an die Produktion zu übermitteln.
In diesem Beispiel erstellen wir einen Auftrag mit zwei Artikeln - einen mit einem dynamischen Rücken und einen mit einer benutzerdefinierten Rücken-URL. Die Daten sollten dem Format des Auftragsobjekts entsprechen:
{
"merchant_api_key": "YourAPIKeyHere:ABCD1234XXXX",
"purchase_order": "",
"currency": "EUR",
"item_details":
[
{
"item_reference": "hardcover_22",
"offering_id": "YourOfferingIDHere",
"quantity": 3,
"file_details":
{
"content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
"content_width": 210,
"content_height": 29.7,
"number_of_pages": 80,
"spine_details":
{
"dynamic_spine_details":
{
"text_font": "Arial",
"text_size": 10,
"text_colour": "#77493f",
"text_top": "top text",
"text_center": "center text",
"text_bottom": "bottom text"
}
}
}
},
{
"item_reference": "hardcover_23",
"offering_id": 233309,
"quantity": 2,
"file_details":
{
"content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
"content_width": 210,
"content_height": 29.7,
"number_of_pages": 80,
"spine_details":
{
"custom_spine_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Custom%20spine%20PDF.pdf"
}
}
}
],
"address_details":
{
"email_address": "joshua@designy.com",
"shipping_address":
{
"first_name": "Joshua",
"last_name": "Grim",
"address_line_1": "Test",
"address_line_2": 1,
"zip_code": "35100",
"city": "Florida",
"state": null,
"country_code": "ARE"
}
}
}
Um für eine Druck-API-Bestellung zu bezahlen, senden Sie eine Anfrage an den Endpunkt Payment. Bevor Sie dies tun können, müssen Sie in der Testumgebung Credits kaufen. Diese Guthaben werden zur Bezahlung der von Ihnen erstellten Aufträge verwendet.
Um Guthaben zu kaufen, gehen Sie zu Dashboard > Einstellungen > API > Guthaben > Guthaben kaufen. In der Testumgebung können Sie Scheinzahlungsmethoden wie Stripe-Testkarten verwenden.
Sobald Sie Guthaben erworben haben, rufen Sie den Endpunkt Zahlung auf, um zu bestätigen, dass der Auftrag abgeschlossen und bereit für die Produktion ist. Dies simuliert ein Szenario, in dem Ihr Kunde Sie bereits direkt bezahlt hat.
Um die Zahlung zu übermitteln, benötigen Sie folgende Angaben:
Die Peecho-API umfasst auch Endpunkte für Auftragsangebote, Produktinformationen und Auftragsstatus.
Alle Einzelheiten finden Sie in unserer API-Dokumentation. Wenn Sie Hilfe beim Testen oder Implementieren von API v3 benötigen, helfen wir Ihnen gerne - wenden Sie sich einfach an uns: support@peecho.com.
