Det offentlige creativehub-API-et lar din egen programvare laste opp kunstverk, bygge og publisere drops og legge inn bestillinger. Forespørsler går til https://escher-v2.creativehub.io/v1 med et esch_live_-bearer-token. Se Slik oppretter du API-tokens for den offentlige /v1-flaten for å få ett.
Dokumentasjon
API-dokumentasjonen er offentlig på https://sell.creativehub.io/api-docs (https://api.creativehub.io tar deg også dit). Hele /v1-flaten er også beskrevet i OpenAPI-endepunktet (/openapi.json på API-tjenesten).
Endepunktgruppene
- Uploads –
POST /v1/uploads(en fil),POST /v1/uploads/ref(et bilde via URL), opplastingsøkter (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(en midlertidig lenke der noen kan slippe filer i en nettleser),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(ett kunstverk). - Page styles –
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(returnerer fem variasjoner å velge mellom),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(en forhåndsvisningslenke 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}.
Laste opp filer
Du kan laste opp filer direkte. POST /v1/uploads tar filens byte som forespørselens body: body er den rå filen, ikke et multipart-skjema. Den godtar JPEG, PNG eller TIFF opptil 2 GB og krever en Content-Length-header. Et multipart-skjema avvises med HTTP 415.
Hvis bildet allerede er hostet, registrerer du det via den offentlige URL-en med POST /v1/uploads/ref i stedet. Opplastingsøkter (/v1/uploads/sessions) og opplastingslenker (/v1/uploads/link) er de to andre rutene.
Sjekk bildene dine selv
Det finnes ikke noe preflight-endepunkt for dpi, dimensjoner, sideforhold eller fargeprofil. Valider hvert bilde i din egen backend før du bestiller, og klargjør det i nøyaktig det bildeområdet du vil ha trykt.
Vil du vite hvordan en trykkeklar fil ser ut, har Slik fotograferer eller skanner du kunstverket ditt fire sjekker som viser om en fil er god nok.
Kanter på varianter
Kanter satt via API-et er bare forhåndsinnstillinger: none, small eller large. Du kan ikke angi kant per side.
Før du automatiserer en utgivelse, er det nyttig å se en fra kjøperens side: Print Drops-siden viser hvordan et tidsbegrenset salg ser ut og foregår.