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 :
| Niveau | Ce que c'est | Ce qui est obligatoire |
|---|---|---|
none | Une fiche montre, sans attestation | Rien |
self | Vous 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 |
expert | Un 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, enmultipart/form-data, champfile, un fichier par appel. La réponse donne unfilename, à 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
httpouhttps, 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é.