Öffentliche Druckdateien-API

Base URL: https://app.customix.io/api

Authentifizierung: So erhalten Sie den Customix-API-Schlüssel

Authorization: Bearer {your-api-token}

Ratenbegrenzung: 100 Anfragen pro Minute (pro Benutzer)

Überblick

Senden Sie eine Produktpersonalisierung als einfachen mehrzeiligen Text und erhalten Sie eine Liste
von Druckdatei-URLs für diese Übermittlung zurück.

Druckdateien erstellen

POST /print-files

Request Body

FeldTypErforderlichBeschreibung
shop_namestringJaName Ihres Shops (z. B. my-etsy-shop)
namestringJaName einer Vorlage, die Ihnen in diesem Shop gehört. Es wird die erste Vorlage verwendet, die zum Namen passt.
contentstringJaMehrzeilige Personalisierung. Jede Zeile hat das Format <option name>: <value>. Ein führendes - ist optional.

Inhaltsformat

Jede Zeile ordnet eine personalisierbare Option der Vorlage einem Wert zu.

  • Optionsnamen werden ohne Beachtung der Groß- und Kleinschreibung zugeordnet, umgebende Leerzeichen werden ignoriert.
  • Text-, Farb- und Datumsoptionen übernehmen den Wert wörtlich, zum Beispiel

Harry, #ffffff, 2026-12-25.

  • Farbfeld-Optionen (Schrift, Bild, Farbe, Layout usw.) erwarten eine ganze Zahl, die

einen der verfügbaren Farbfeldwerte auswählt. Standardmäßig wählt 1 den ersten
Wert, 2 den zweiten usw.

Beispiel:

- Enter your name: Harry
- Text color: #ffffff
- Font: 1

Antwort 201

{
  "id": "01jyz5kqxz2hrcwqzdq4jdv7r9",
  "print_file_urls": [
    "https://.../1.png",
    "https://.../2.png"
  ]
}
FeldTypBeschreibung
idstringKennung der Übermittlung
print_file_urlsstring[]Eine URL pro Druckdatei der Vorlage, in der Reihenfolge der Vorlage

Die Druckdateien sind unter den zurückgegebenen URLs verfügbar, sobald die Erzeugung abgeschlossen ist
(in der Regel wenige Sekunden nach der Antwort).

Fehlerantworten

StatusBodyUrsache
401{"message": "Unauthenticated."}Bearer-Token fehlt oder ist ungültig
403{"message": "Unauthenticated"}Das Token ist gültig, aber der Aufrufer hat keinen Zugriff auf shop_name
404{"message": "Template not found: …"}In diesem Shop existiert keine Vorlage mit diesem name
422{"errors": {"shop_name": […], "name": […], "content": […]}}Pflichtfelder fehlen
422{"message": "Unknown option: <name>"}Eine Zeile verweist auf eine Option, die in der Vorlage nicht existiert
422{"message": "Swatch index N is out of range for option '…' …"}Der Farbfeldindex liegt außerhalb des verfügbaren Bereichs
422{"message": "Option '…' expects an integer swatch index, got …"}Nicht ganzzahliger Wert an eine Farbfeld-Option übergeben

Beispielanfrage

curl -X POST 'https://app.customix.io/api/print-files' \
  -H 'Authorization: Bearer 01jyz0z…|abc…' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "shop_name": "my-etsy-shop",
    "name": "My Template",
    "content": "- Enter your name: Harry\n- Text color: #ffffff\n- Font: 1"
  }'

Aktualisiert am: 20.05.2026