Artículo 5 de 8
Los campos obligatorios y el formato de las fotos
Crear un reloj no requiere ningún campo. Un pasaporte, sí: lo obligatorio depende de su nivel de autenticación.
Crear el reloj: envíe lo que sabe
POST /watches/create acepta un reloj incompleto: ningún campo es obligatorio en este paso. Dele su propio identificador en externalRef: si envía de nuevo la misma referencia, se devuelve el reloj existente en lugar de crear un segundo.
El pasaporte: según su nivel
El campo authenticationType fija el nivel del futuro pasaporte:
| Nivel | Qué es | Qué es obligatorio |
|---|---|---|
none | Una ficha de reloj, sin autenticación | Nada |
self | Usted mismo certifica el pasaporte (un fabricante o un detallista) | El fabricante, el modelo, la referencia, el año o la década, los números de serie de la caja y del movimiento |
expert | Un experto independiente lo valida (talleres y centros de servicio) | Como para self, y el detalle de abajo |
Para un pasaporte self
- el fabricante (
watchBrand), el modelo (watchModel), la referencia (watchReference); - el año o la década (
watchYearOrDecade); - el número de serie de la caja (
serialCase), salvo si no tiene o es ilegible; - el número de serie del movimiento (
serialMovement), salvo si el reloj no se ha abierto, no tiene número o el número es ilegible.
Escriba el fabricante, el modelo y la referencia tal como los escribe la marca: Watch Certificate™ los vincula a su catálogo de marcas, modelos y referencias, y la lectura del pasaporte (GET /certificates/{certificateCardId}) devuelve la marca encontrada en brandId, null si no encuentra ninguna.
Para un pasaporte expert
Además: las dimensiones, el ancho entre asas, la hermeticidad, el pulido, el material de la caja, la autenticidad y el estado de cada parte visible, y las fotos del reloj y de cada parte o documento declarado. Para un reloj vendido nuevo, no se piden la autenticidad, el estado ni el pulido.
En todos los casos
Dos pasaportes de un mismo fabricante no pueden tener el mismo número de serie de caja o de movimiento.
Comprobar antes de vincular
POST /certificates/can-link-card le indica, antes de vincular la tarjeta, qué falta (missingFields) y qué números de serie ya están registrados (alreadyRegisteredFields). Complete el reloj con PUT /watches/edit y después vincule la tarjeta.
Las fotos
- Envío:
POST /files/upload, enmultipart/form-data, campofile, un archivo por llamada. La respuesta da unfilename, que se coloca en la lista de fotos correspondiente del reloj (photoFaceList, photoBackList, photoSerialCaseList…). - Formatos: JPEG, PNG o HEIC para las fotos (guardadas en JPEG), PDF para los documentos (factura, garantía, papeles).
- Foto frontal: envíela con
?isThumb=true, para que las listas muestren su miniatura. - O una dirección web: una lista de fotos también acepta URL públicas, en
httpohttps, de 25 MB como máximo, descargadas en menos de 60 segundos. Copiamos el archivo; una URL inaccesible se ignora. - Tamaño: las fotos se redimensionan a 1800 píxeles de ancho como máximo.
Las fotos son de acceso público, como en la página del pasaporte; los PDF siguen siendo privados y solo se leen con su clave.