第 5 篇,共 8 篇

必填字段与照片格式

创建手表无需任何必填字段。护照则需要:必填内容取决于其认证级别。

创建手表:发送您已知的信息

POST /watches/create 接受信息不完整的手表:此步骤没有必填字段。请在 externalRef 中填写您自己的标识符:再次发送相同的参考编号会返回已有的手表,而不会再创建一块。

护照:取决于其级别

authenticationType 字段决定未来护照的级别:

等级含义必填内容
none一份手表资料,无认证无
self由您自己为护照作证(制造商或零售商)制造商、型号、参考编号、年份或年代、表壳和机芯序列号
expert由独立专家验证(工坊和服务中心)与 self 相同,另加下方所列内容

self 护照

  • 制造商(watchBrand)、型号(watchModel)、参考编号(watchReference);
  • 年份或年代(watchYearOrDecade);
  • 表壳序列号(serialCase),没有或无法辨认时除外;
  • 机芯序列号(serialMovement),手表未开启、没有编号或编号无法辨认时除外。

请按品牌的写法填写制造商、型号和参考编号:Watch Certificate™ 会将其关联到品牌、型号和参考编号目录,读取手表护照(GET /certificates/{certificateCardId})时会在 brandId 中返回找到的品牌,未找到时为 null。

expert 护照

此外:尺寸、表耳间距、防水性、抛光、表壳材质、每个可见部件的真伪和状况,以及手表和每个已申报部件或文件的照片。对于全新售出的手表,不要求真伪、状况和抛光信息。

在任何情况下

同一制造商的两本护照不能使用相同的表壳或机芯序列号。

关联前先检查

POST /certificates/can-link-card 会在关联卡片之前告诉您缺少哪些内容(missingFields)以及哪些序列号已被登记(alreadyRegisteredFields)。请用 PUT /watches/edit 补全手表信息,然后再关联卡片。

照片

  • 上传:POST /files/upload,格式为 multipart/form-data,字段 file,每次调用一个文件。响应会返回一个 filename,请将其放入手表对应的照片列表(photoFaceList, photoBackList, photoSerialCaseList…)。
  • 格式:照片为 JPEG、PNG 或 HEIC(保存为 JPEG),文件(发票、保修卡、证书)为 PDF。
  • 正面照片:请附上 ?isThumb=true 发送,列表即会显示其缩略图。
  • 或网址:照片列表也接受 http 或 https 的公开 URL,大小不超过 25 MB,需在 60 秒内获取。我们会复制该文件;无法访问的 URL 将被忽略。
  • 尺寸:照片会被缩放至最宽 1,800 像素。

照片可公开访问,与护照页面相同;PDF 保持私密,只能使用您的密钥读取。

下一篇API 返回什么