L'API pubblica di creativehub permette al tuo software di caricare opere, creare e pubblicare drop e fare ordini. Le richieste vanno a https://escher-v2.creativehub.io/v1 con un bearer token esch_live_: vedi Come creare token API per la superficie pubblica /v1 per ottenerne uno.
Documentazione
La documentazione dell'API è pubblica su https://sell.creativehub.io/api-docs (anche https://api.creativehub.io ti porta lì). L'intera superficie /v1 è descritta anche nell'endpoint OpenAPI (/openapi.json sul servizio API).
I gruppi di endpoint
- Uploads:
POST /v1/uploads(un file),POST /v1/uploads/ref(un'immagine tramite URL), sessioni di caricamento (POST /v1/uploads/sessions,…/sessions/complete),POST /v1/uploads/link(un link temporaneo dove qualcuno trascina i file in un 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, firma, lettera). - 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(un drop),POST /v1/drops/{drop_id}/products/{product_id}/recommendations(una singola opera). - Page styles:
GET /v1/styles/schema,GET /v1/styles,POST /v1/styles/extract(restituisce cinque variazioni tra cui scegliere),GET /v1/styles/variations/{id},POST /v1/styles,GET/PATCH/DELETE /v1/styles/{style_id},POST /v1/drops/{drop_id}/style-preview(un link di anteprima di 15 minuti). - 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}.
Caricare i file
Puoi caricare i file direttamente. POST /v1/uploads accetta i byte del file come corpo della richiesta: il corpo è il file grezzo, non un modulo multipart. Accetta JPEG, PNG o TIFF fino a 2 GB e richiede un header Content-Length; un modulo multipart viene rifiutato con HTTP 415.
Se l'immagine è già ospitata, registrala invece tramite il suo URL pubblico con POST /v1/uploads/ref. Le sessioni di caricamento (/v1/uploads/sessions) e i link di caricamento (/v1/uploads/link) sono le altre due strade.
Controlla tu le tue immagini
Non c'è un endpoint di preflight per dpi, dimensioni, rapporto d'aspetto o profilo colore. Convalida ogni immagine nel tuo backend prima di ordinare e preparala con l'esatta area d'immagine che vuoi stampare.
Per sapere com'è fatto un file pronto per la stampa, come fotografare o scansionare le tue opere propone quattro controlli che mostrano se un file è abbastanza buono.
Bordi sulle varianti
I bordi impostati tramite l'API sono solo preset: none, small o large. Non puoi impostare un bordo per ciascun lato.
Prima di automatizzare un'uscita conviene vederne una dal lato dell'acquirente: la pagina Print Drops mostra come si presenta e come si svolge una vendita a tempo limitato.