Vad det publika /v1-API:t kan göra

publikt api

Det publika creativehub-API:t låter din egen programvara ladda upp konstverk, bygga och publicera drops och lägga ordrar. Anrop går till https://escher-v2.creativehub.io/v1 med en esch_live_-bearer-token. Se Så skapar du API-tokens för den publika /v1-ytan för att skaffa en.

Dokumentation

API-dokumentationen är publik på https://sell.creativehub.io/api-docs (https://api.creativehub.io tar dig också dit). Hela /v1-ytan beskrivs också i OpenAPI-endpointen (/openapi.json på API-tjänsten).

Endpoint-grupperna

  • Uploads – POST /v1/uploads (en fil), POST /v1/uploads/ref (en bild via URL), uppladdningssessioner (POST /v1/uploads/sessions, …/sessions/complete), POST /v1/uploads/link (en tillfällig länk där någon släpper filer i en webbläsare), 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 (logotyp, signatur, brev).
  • 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 (en drop), POST /v1/drops/{drop_id}/products/{product_id}/recommendations (ett konstverk).
  • Page styles – GET /v1/styles/schema, GET /v1/styles, POST /v1/styles/extract (returnerar fem variationer att välja bland), GET /v1/styles/variations/{id}, POST /v1/styles, GET / PATCH / DELETE /v1/styles/{style_id}, POST /v1/drops/{drop_id}/style-preview (en förhandsvisningslänk på 15 minuter).
  • 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}.

Ladda upp filer

Du kan ladda upp filer direkt. POST /v1/uploads tar filens bytes som anropets body: bodyn är den råa filen, inte ett multipart-formulär. Den accepterar JPEG, PNG eller TIFF upp till 2 GB och kräver en Content-Length-header. Ett multipart-formulär avvisas med HTTP 415.

Om bilden redan är hostad registrerar du den med dess publika URL via POST /v1/uploads/ref i stället. Uppladdningssessioner (/v1/uploads/sessions) och uppladdningslänkar (/v1/uploads/link) är de två andra vägarna.

Kontrollera dina bilder själv

Det finns ingen preflight-endpoint för dpi, mått, bildproportion eller färgprofil. Validera varje bild i din egen backend innan du beställer, och förbered den i exakt den bildyta du vill ha tryckt.

Vill du veta hur en tryckfärdig fil ser ut har så fotograferar eller skannar du dina konstverk fyra kontroller som visar om en fil är bra nog.

Kanter på varianter

Kanter som anges via API:t är bara förinställningar: none, small eller large. Du kan inte ange kant per sida.

Innan du automatiserar ett släpp hjälper det att se ett från köparens håll: sidan Print Drops visar hur en tidsbegränsad försäljning ser ut och går till.

Behöver du fortfarande hjälp?

Ställ en fråga till assistenten i appen från din creativehub-instrumentpanel, eller mejla oss — en riktig person svarar. info@creativehub.io