Hvad det offentlige /v1 API kan

offentligt api

Med creativehubs offentlige API kan din egen software uploade kunstværker, bygge og publicere drops og afgive ordrer. Anmodninger går til https://escher-v2.creativehub.io/v1 med et esch_live_-bearer-token. Se Sådan opretter du API-tokens til den offentlige /v1-flade for at få et.

Dokumentation

API-dokumentationen er offentlig på https://sell.creativehub.io/api-docs (https://api.creativehub.io fører dig også dertil). Hele /v1-fladen er også beskrevet ved OpenAPI-endpointet (/openapi.json på API-tjenesten).

Endpointgrupperne

  • Uploads: POST /v1/uploads (en fil), POST /v1/uploads/ref (et billede via URL), uploadsessioner (POST /v1/uploads/sessions, …/sessions/complete), POST /v1/uploads/link (et midlertidigt link, hvor nogen kan slippe filer i en browser), 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, 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 (ét kunstværk).
  • Page styles: GET /v1/styles/schema, GET /v1/styles, POST /v1/styles/extract (returnerer fem variationer at vælge imellem), GET /v1/styles/variations/{id}, POST /v1/styles, GET / PATCH / DELETE /v1/styles/{style_id}, POST /v1/drops/{drop_id}/style-preview (et forhåndsvisningslink på 15 minutter).
  • 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}.

Upload af filer

Du kan uploade filer direkte. POST /v1/uploads tager filens bytes som anmodningens body: bodyen er den rå fil, ikke en multipart-formular. Den accepterer JPEG, PNG eller TIFF op til 2 GB og kræver en Content-Length-header. En multipart-formular afvises med HTTP 415.

Hvis billedet allerede er hostet, kan du i stedet registrere det via dets offentlige URL med POST /v1/uploads/ref. Uploadsessioner (/v1/uploads/sessions) og uploadlinks (/v1/uploads/link) er de to andre veje.

Tjek dine billeder selv

Der er intet preflight-endpoint for dpi, dimensioner, billedformat eller farveprofil. Valider hvert billede i dit eget backend, før du bestiller, og klargør det til det nøjagtige billedområde, du vil have printet.

Vil du vide, hvordan en printklar fil ser ud, har Sådan fotograferer eller scanner du dit værk fire tjek, der viser, om en fil er god nok.

Kanter på varianter

Kanter, der angives via API'et, er kun forudindstillinger: none, small eller large. Du kan ikke angive en kant pr. side.

Før du automatiserer en udgivelse, hjælper det at se en fra køberens side: Print Drops-siden viser, hvordan et tidsbegrænset salg ser ud og forløber.

Har du stadig brug for hjælp?

Spørg hjælpeassistenten i appen fra dit creativehub dashboard, eller skriv til os — en rigtig person svarer. info@creativehub.io