Article 5 sur 8

Les champs obligatoires et le format des photos

Créer une montre ne demande aucun champ. Un passeport, si : ce qui est obligatoire dépend de son niveau d'attestation.

Créer la montre : envoyez ce que vous savez

POST /watches/create accepte une montre incomplète : aucun champ n'est obligatoire à cette étape. Donnez-lui votre propre identifiant dans externalRef : renvoyer la même référence renvoie la montre existante au lieu d'en créer une deuxième.

Le passeport : selon son niveau

Le champ authenticationType fixe le niveau du futur passeport :

NiveauCe que c'estCe qui est obligatoire
noneUne fiche montre, sans attestationRien
selfVous attestez le passeport vous-même (une manufacture ou un détaillant)La manufacture, le modèle, la référence, l'année ou la décennie, les numéros de série du boîtier et du mouvement
expertUn expert indépendant le valide (ateliers et centres de service)Comme pour self, et le détail ci-dessous

Pour un passeport self

  • la manufacture (watchBrand), le modèle (watchModel), la référence (watchReference) ;
  • l'année ou la décennie (watchYearOrDecade) ;
  • le numéro de série du boîtier (serialCase), sauf s'il n'y en a pas ou s'il est illisible ;
  • le numéro de série du mouvement (serialMovement), sauf montre non ouverte, sans numéro ou numéro illisible.

Écrivez la manufacture, le modèle et la référence comme la marque les écrit : Watch Certificate™ les relie à son catalogue de marques, de modèles et de références, et la lecture du passeport (GET /certificates/{certificateCardId}) renvoie la marque trouvée dans brandId, null quand il n'y en a aucune.

Pour un passeport expert

En plus : les dimensions, l'entre-cornes, l'étanchéité, le polissage, la matière du boîtier, l'authenticité et l'état de chaque partie visible, et les photos de la montre et de chaque partie ou document déclaré. Pour une montre vendue neuve, l'authenticité, l'état et le polissage ne sont pas demandés.

Dans tous les cas

Deux passeports d'une même manufacture ne peuvent pas porter le même numéro de série de boîtier ou de mouvement.

Vérifier avant de lier

POST /certificates/can-link-card vous dit, avant de lier la carte, ce qui manque (missingFields) et quels numéros de série sont déjà enregistrés (alreadyRegisteredFields). Complétez la montre avec PUT /watches/edit, puis liez la carte.

Les photos

  • Envoi : POST /files/upload, en multipart/form-data, champ file, un fichier par appel. La réponse donne un filename, à placer dans la liste de photos voulue de la montre (photoFaceList, photoBackList, photoSerialCaseList…).
  • Formats : JPEG, PNG ou HEIC pour les photos (enregistrées en JPEG), PDF pour les documents (facture, garantie, papiers).
  • Photo de face : envoyez-la avec ?isThumb=true, pour que les listes affichent sa vignette.
  • Ou une adresse web : une liste de photos accepte aussi des URL publiques, en http ou https, de 25 Mo au plus, récupérées en moins de 60 secondes. Nous copions le fichier ; une URL injoignable est ignorée.
  • Taille : les photos sont redimensionnées à 1 800 pixels de large au plus.

Les photos sont en accès public, comme sur la page du passeport ; les PDF restent privés et ne se lisent qu'avec votre clé.

Article suivantCe que renvoie l'API