Julkisen creativehub-API:n avulla oma ohjelmistosi voi ladata teoksia, rakentaa ja julkaista dropeja sekä tehdä tilauksia. Pyynnöt menevät osoitteeseen https://escher-v2.creativehub.io/v1 esch_live_-bearer-tunnisteella. Tunnisteen hankkimisesta kerrotaan artikkelissa Näin luot API-tunnisteet julkiselle /v1-rajapinnalle.
Dokumentaatio
API-dokumentaatio on julkinen osoitteessa https://sell.creativehub.io/api-docs (myös https://api.creativehub.io johtaa sinne). Koko /v1-rajapinta on kuvattu myös OpenAPI-päätepisteessä (/openapi.json API-palvelussa).
Päätepisteryhmät
- Uploads –
POST /v1/uploads(tiedosto),POST /v1/uploads/ref(kuva URL-osoitteella), latausistunnot (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(tilapäinen linkki, jonka kautta joku pudottaa tiedostoja selaimessa),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, allekirjoitus, kirje). - 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(drop),POST /v1/drops/{drop_id}/products/{product_id}/recommendations(yksi teos). - Page styles –
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(palauttaa viisi valittavaa vaihtoehtoa),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(15 minuutin esikatselulinkki). - 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}.
Tiedostojen lataaminen
Voit ladata tiedostoja suoraan. POST /v1/uploads ottaa tiedoston tavut pyynnön runkona: runko on raakatiedosto, ei multipart-lomake. Se hyväksyy JPEG-, PNG- tai TIFF-tiedostot enintään 2 Gt ja vaatii Content-Length-otsakkeen; multipart-lomake hylätään HTTP 415 -vastauksella.
Jos kuva on jo isännöity, rekisteröi se julkisella URL-osoitteella käyttämällä POST /v1/uploads/ref. Latausistunnot (/v1/uploads/sessions) ja latauslinkit (/v1/uploads/link) ovat kaksi muuta reittiä.
Tarkista kuvasi itse
Dpi:lle, mitoille, kuvasuhteelle tai värinprofiilille ei ole esitarkistuspäätepistettä. Validoi jokainen kuva omassa taustajärjestelmässäsi ennen tilaamista ja valmistele se täsmälleen siihen kuva-alaan, jonka haluat tulostettavaksi.
Sen, miltä tulostusvalmis tiedosto näyttää, kertoo Näin valokuvaat tai skannaat teoksesi, jonka neljä tarkistusta näyttävät, onko tiedosto riittävän hyvä.
Reunukset varianteissa
API:n kautta asetettavat reunukset ovat vain esiasetuksia: none, small tai large. Reunusta ei voi asettaa sivukohtaisesti.
Ennen kuin automatisoit julkaisun, se kannattaa nähdä ostajan silmin: Print Drops -sivu näyttää, miltä aikarajattu myynti näyttää ja miten se etenee.