Vai al contenuto
API

Creare un flusso di personalizzazione con l’API Order

Se i tuoi clienti creano la propria cover nella tua app, l’API Order ti permette di mandare la grafica finita direttamente in produzione e di seguire l’ordine fino alla consegna con i webhook.

Cosa ottieni

L’accesso API è incluso nel piano Pro. Crei una chiave nell’account, e l’URL di base è https://app.tullunprint.com/api/v1. Non c’è una registrazione separata per sviluppatori.

Il flusso

  • Leggi il catalogo con GET /catalog per elencare i tipi di cover e i dispositivi supportati
  • Rendi disponibile la grafica del cliente a un link https pubblico; l’ordine la include come file dell’articolo
  • Crea l’ordine con POST /orders: il tipo di cover, il dispositivo, il link della grafica e l’indirizzo di spedizione
  • Registra un webhook con POST /webhooks e ricevi i cambi di stato man mano che l’ordine attraversa produzione e spedizione
  • Interroga GET /orders/{id} in qualsiasi momento per lo stato attuale e il tracciamento

Requisiti della grafica

Invia file pronti per la stampa: 300 dpi, sRGB, con abbondanza. L’API verifica le dimensioni rispetto all’area di stampa della cover scelta, quindi un’interfaccia di personalizzazione dovrebbe esportare alla dimensione del modello di quel dispositivo.

Gli stati che interessano al tuo cliente

Received, Being made e On its way, con il numero di tracciamento appena c’è. Riportali sulla tua pagina ordine, così il cliente vede sempre le stesse parole nello stesso ordine.

Dove trovare i dettagli

Parametri degli endpoint, dati di esempio e chiavi sono nella pagina API del tuo account venditore. La pagina API pubblica di questo sito spiega il modello in sintesi.

Tutte le risorse

Pronto a costruire il tuo business POD?

Collega il tuo negozio, crea i tuoi prodotti e lascia a noi produzione e fulfillment.