Mitä julkinen /v1-API osaa

julkinen api

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.

Tarvitsetko vielä apua?

Kysy sovelluksen sisäiseltä avustajalta creativehub-kojelaudastasi tai lähetä meille sähköpostia — oikea ihminen vastaa. info@creativehub.io