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:
| Livello | Cos'è | Cosa è obbligatorio |
|---|---|---|
none | Una scheda orologio, senza autenticazione | Niente |
self | Attesti 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 |
expert | Un 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, comemultipart/form-data, campofile, un file per chiamata. La risposta fornisce unfilename, 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
httpohttps, 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.