Articolo 5 di 8

I campi obbligatori e il formato delle foto

Creare un orologio non richiede alcun campo. Un passaporto sì: ciò che è obbligatorio dipende dal suo livello di autenticazione.

Creare l'orologio: invia ciò che sai

POST /watches/create accetta un orologio incompleto: nessun campo è obbligatorio in questa fase. Dagli il tuo identificativo in externalRef: inviando di nuovo lo stesso riferimento, viene restituito l'orologio esistente invece di crearne un secondo.

Il passaporto: secondo il suo livello

Il campo authenticationType fissa il livello del futuro passaporto:

LivelloCos'èCosa è obbligatorio
noneUna scheda orologio, senza autenticazioneNiente
selfAttesti tu stesso il passaporto (una manifattura o un rivenditore)La manifattura, il modello, la referenza, l'anno o il decennio, i numeri di serie della cassa e del movimento
expertUn esperto indipendente lo convalida (laboratori e centri assistenza)Come per self, più i dettagli qui sotto

Per un passaporto self

  • la manifattura (watchBrand), il modello (watchModel), la referenza (watchReference);
  • l'anno o il decennio (watchYearOrDecade);
  • il numero di serie della cassa (serialCase), salvo se non c'è o è illeggibile;
  • il numero di serie del movimento (serialMovement), salvo orologio non aperto, senza numero o con numero illeggibile.

Scrivi la manifattura, il modello e la referenza come li scrive la marca: Watch Certificate™ li collega al suo catalogo di marche, modelli e referenze, e la lettura del passaporto (GET /certificates/{certificateCardId}) restituisce la marca trovata in brandId, null se non ne trova nessuna.

Per un passaporto expert

In più: le dimensioni, l'interasse delle anse, l'impermeabilità, la lucidatura, il materiale della cassa, l'autenticità e lo stato di ogni parte visibile, e le foto dell'orologio e di ogni parte o documento dichiarato. Per un orologio venduto nuovo, autenticità, stato e lucidatura non sono richiesti.

In ogni caso

Due passaporti della stessa manifattura non possono avere lo stesso numero di serie di cassa o di movimento.

Verificare prima di collegare

POST /certificates/can-link-card ti dice, prima di collegare la carta, cosa manca (missingFields) e quali numeri di serie sono già registrati (alreadyRegisteredFields). Completa l'orologio con PUT /watches/edit, poi collega la carta.

Le foto

  • Invio: POST /files/upload, come multipart/form-data, campo file, un file per chiamata. La risposta fornisce un filename, da inserire nell'elenco di foto dell'orologio a cui appartiene (photoFaceList, photoBackList, photoSerialCaseList…).
  • Formati: JPEG, PNG o HEIC per le foto (salvate in JPEG), PDF per i documenti (fattura, garanzia, documenti).
  • Foto frontale: inviala con ?isThumb=true, così gli elenchi mostrano la sua miniatura.
  • Oppure un indirizzo web: un elenco di foto accetta anche URL pubblici, in http o https, di 25 MB al massimo, recuperati in meno di 60 secondi. Copiamo il file; un URL irraggiungibile viene ignorato.
  • Dimensioni: le foto vengono ridimensionate a 1.800 pixel di larghezza al massimo.

Le foto sono accessibili pubblicamente, come sulla pagina del passaporto; i PDF restano privati e si leggono solo con la tua chiave.

Articolo successivoCosa restituisce l'API