第 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 保持私密,只能使用您的密钥读取。