記事 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は非公開のままで、お客様のキーでのみ読み取れます。

次の記事APIが返すもの