記事 5 / 8
必須項目と写真の形式
時計の作成に必須項目はありません。パスポートには必須項目があり、その内容は認証レベルによって異なります。
時計の作成:わかっていることを送信
POST /watches/createは不完全な時計も受け付けます。この段階で必須の項目はありません。externalRefに独自の識別子を指定してください。同じ参照番号を再送信すると、2つ目を作成せずに既存の時計を返します。
パスポート:レベルに応じて
authenticationType項目で、作成されるパスポートのレベルが決まります:
| レベル | 内容 | 必須項目 |
|---|---|---|
none | 認証なしの時計情報 | なし |
self | お客様自身がパスポートを証明します(メーカーまたは小売業者) | メーカー、モデル、リファレンス、年または年代、ケースとムーブメントのシリアル番号 |
expert | 独立した専門家が検証します(工房とサービスセンター) | selfと同じ項目、および下記の詳細 |
selfパスポートの場合
- メーカー(
watchBrand)、モデル(watchModel)、リファレンス(watchReference) - 年または年代(
watchYearOrDecade) - ケースのシリアル番号(
serialCase)。番号がない場合や判読できない場合を除く - ムーブメントのシリアル番号(
serialMovement)。時計を開けていない場合、番号がない場合、判読できない場合を除く。
メーカー、モデル、リファレンスはブランドの表記どおりに入力してください。Watch Certificate™がブランド、モデル、リファレンスのカタログに紐づけ、時計パスポートの取得(GET /certificates/{certificateCardId})は見つかったブランドをbrandIdで返します(見つからない場合はnull)。
expertパスポートの場合
さらに:サイズ、ラグ幅、防水性、研磨、ケース素材、見える各部の真正性と状態、時計の写真と申告した各部品・書類の写真。新品で販売する時計については、真正性、状態、研磨は求められません。
どの場合も
同じメーカーの2つのパスポートが、同じケースまたはムーブメントのシリアル番号を持つことはできません。
紐付け前の確認
POST /certificates/can-link-cardは、カードを紐付ける前に、不足している項目(missingFields)と登録済みのシリアル番号(alreadyRegisteredFields)を返します。PUT /watches/editで時計を補完してから、カードを紐付けてください。
写真
- アップロード:
POST /files/upload、multipart/form-data形式、フィールドfile、1回の呼び出しで1ファイル。レスポンスで返されるfilenameを、時計の該当する写真リスト(photoFaceList, photoBackList, photoSerialCaseList…)に入れてください。 - 形式:写真はJPEG、PNG、HEIC(JPEGで保存)、書類(請求書、保証書、付属書類)はPDF。
- 正面写真:
?isThumb=trueを付けて送信すると、一覧にそのサムネイルが表示されます。 - またはウェブアドレス:写真リストには、
httpまたはhttpsの公開URL(25 MB以下、60秒以内に取得できるもの)も指定できます。ファイルは当社でコピーし、アクセスできないURLは無視されます。 - サイズ:写真は最大で幅1,800ピクセルにリサイズされます。
写真はパスポートのページと同様に公開されます。PDFは非公開のままで、お客様のキーでのみ読み取れます。