Cosa può fare l'API pubblica /v1

api pubblica

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.

Hai ancora bisogno di aiuto?

Chiedi all'assistente integrato dal tuo dashboard creativehub, oppure scrivici — un vero operatore ti risponderà. info@creativehub.io