Was die öffentliche /v1-API kann

öffentliche API

Mit der öffentlichen creativehub-API kann deine eigene Software Artwork hochladen, Drops erstellen und veröffentlichen und Bestellungen aufgeben. Anfragen gehen an https://escher-v2.creativehub.io/v1 mit einem esch_live_-Bearer-Token. Wie du eines bekommst, steht unter So erstellst du API-Tokens für die öffentliche /v1-Schnittstelle.

Dokumentation

Die API-Dokumentation ist öffentlich unter https://sell.creativehub.io/api-docs (auch https://api.creativehub.io führt dorthin). Die gesamte /v1-Schnittstelle ist außerdem am OpenAPI-Endpunkt beschrieben (/openapi.json beim API-Dienst).

Die Endpunktgruppen

  • Uploads: POST /v1/uploads (eine Datei), POST /v1/uploads/ref (ein Bild per URL), Upload-Sitzungen (POST /v1/uploads/sessions, …/sessions/complete), POST /v1/uploads/link (ein temporärer Link, über den jemand Dateien im Browser ablegt), GET /v1/uploads, GET /v1/uploads/{id}.
  • Drops: POST /v1/drops, GET /v1/drops, GET / PATCH / DELETE /v1/drops/{drop_id}, POST /v1/drops/{drop_id}/assets (Logo, Signatur, Brief).
  • Products: POST /v1/drops/{drop_id}/products, PUT /v1/drops/{drop_id}/products/{product_id}/variants, DELETE …/products/{product_id}; GET /v1/products, GET /v1/products/{id}, GET /v1/products/{id}/variants.
  • Recommendations: POST /v1/recommendations (ein Drop), POST /v1/drops/{drop_id}/products/{product_id}/recommendations (ein Artwork).
  • Page styles: GET /v1/styles/schema, GET /v1/styles, POST /v1/styles/extract (liefert fünf Variationen zur Auswahl), GET /v1/styles/variations/{id}, POST /v1/styles, GET / PATCH / DELETE /v1/styles/{style_id}, POST /v1/drops/{drop_id}/style-preview (ein Vorschau-Link, 15 Minuten gültig).
  • Publishing: POST /v1/drops/{drop_id}/publish, GET /v1/drops/{drop_id}/publish-attempts/latest.
  • Orders and invoices: POST /v1/orders/quote, POST /v1/orders, GET /v1/orders, GET /v1/orders/{id}, GET /v1/invoices, GET /v1/invoices/{id}.

Dateien hochladen

Du kannst Dateien direkt hochladen. POST /v1/uploads nimmt die Bytes der Datei als Request-Body entgegen: Der Body ist die Rohdatei, kein Multipart-Formular. Akzeptiert werden JPEG, PNG oder TIFF bis 2 GB, und ein Content-Length-Header ist erforderlich; ein Multipart-Formular wird mit HTTP 415 abgelehnt.

Wenn das Bild bereits gehostet ist, registriere es stattdessen mit POST /v1/uploads/ref über seine öffentliche URL. Upload-Sitzungen (/v1/uploads/sessions) und Upload-Links (/v1/uploads/link) sind die beiden anderen Wege.

Prüfe deine Bilder selbst

Es gibt keinen Preflight-Endpunkt für dpi, Abmessungen, Seitenverhältnis oder Farbprofil. Prüfe jedes Bild in deinem eigenen Backend vor der Bestellung und bereite es exakt in der Bildfläche vor, die gedruckt werden soll.

Wie eine druckfertige Datei aussieht, zeigt So fotografierst oder scannst du dein Kunstwerk mit vier Prüfungen, an denen du erkennst, ob eine Datei gut genug ist.

Ränder bei Varianten

Ränder, die über die API festgelegt werden, sind nur Presets: none, small oder large. Du kannst keinen Rand pro Seite festlegen.

Bevor du eine Veröffentlichung automatisierst, hilft ein Blick aus Käufersicht: Die Seite „Print Drops“ zeigt, wie ein zeitlich begrenzter Verkauf aussieht und abläuft.

Brauchst du noch Hilfe?

Nutze den integrierten Help-Assistenten von deinem creativehub-Dashboard oder schreib uns eine E-Mail — eine echte Person antwortet dir. info@creativehub.io