Article 5 of 8
The required fields and the photos' format
Creating a watch requires no field. A passport does: what is required depends on its level of attestation.
Creating the watch: send what you know
POST /watches/create accepts an incomplete watch: no field is required at this step. Give it your own identifier in externalRef: sending the same reference again returns the existing watch instead of creating a second one.
The passport: by its level
The authenticationType field sets the future passport's level:
| Level | What it is | What is required |
|---|---|---|
none | A watch sheet, without attestation | Nothing |
self | You attest the passport yourself (a manufacture or a retailer) | The manufacture, the model, the reference, the year or decade, the case and movement serial numbers |
expert | An independent expert validates it (workshops and service centers) | As for self, and the details below |
For a self passport
- the manufacture (
watchBrand), the model (watchModel), the reference (watchReference); - the year or the decade (
watchYearOrDecade); - the case serial number (
serialCase), unless there is none or it is illegible; - the movement serial number (
serialMovement), unless the watch is not opened, has no number or the number is illegible.
Write the manufacture, the model and the reference as the brand spells them: Watch Certificate™ links them to its catalog of brands, models and references, and the passport's read (GET /certificates/{certificateCardId}) returns the brand found in brandId, null when none is.
For an expert passport
In addition: the dimensions, the lug width, the water resistance, the polishing, the case material, the authenticity and condition of each visible part, and the photos of the watch and of each part or document declared. For a watch sold new, the authenticity, the condition and the polishing are not asked for.
In every case
Two passports of the same manufacture cannot carry the same case or movement serial number.
Checking before linking
POST /certificates/can-link-card tells you, before you link the card, what is missing (missingFields) and which serial numbers are already registered (alreadyRegisteredFields). Complete the watch with PUT /watches/edit, then link the card.
The photos
- Upload:
POST /files/upload, asmultipart/form-data, fieldfile, one file per call. The response gives afilename, to put in the watch's photo list it belongs to (photoFaceList, photoBackList, photoSerialCaseList…). - Formats: JPEG, PNG or HEIC for photos (saved as JPEG), PDF for documents (invoice, warranty, papers).
- Front photo: send it with
?isThumb=true, so that the lists show its thumbnail. - Or a web address: a photo list also accepts public URLs, in
httporhttps, of 25 MB at most, fetched in less than 60 seconds. We copy the file; an unreachable URL is ignored. - Size: photos are resized to 1,800 pixels wide at most.
Photos are publicly accessible, as on the passport's page; PDFs stay private and can only be read with your key.