Replenishmentサービスは、ユーザーを喜ばせ、ショッピング体験の手間を解消することを目的としています。DRSを利用できるすべてのデバイスでは、消耗品(コーヒーポッド、洗剤、インクなど)がなくなる前に自動的に補充するよう選択できます。事前登録により、Amazonで買い物をするユーザーがDRSを利用できるデバイスをカートに追加するときにその選択ができるようにし、そのデバイスを受け取るときに一連のセットアップ操作を提供します。Replenishmentサービスをセットアップするかどうかも尋ねられます。この段階では、デバイスの製造元はそのデバイスのシリアル番号をユーザーのAmazonアカウントに関連付け、ストックがなくなる前に新しい補充品を受け取れるようにします。お使いのソリューションで事前登録を連携すると、ユーザーがそのデバイスをAmazonで購入し、DRS機能をセットアップした段階ですぐにそのデバイスのシリアル番号を提供します。Amazonのレジ操作中に、ユーザーは自動的に再注文を行う商品を1つ以上選択できます。その設定はAmazonのクラウドに保存されます。これにより、皆さまはユーザーが事前登録されたデバイスを箱から取り出して利用を開始する前にそのデバイスの許可トークンを直接交換し、ユーザーの利用開始手続きの簡略化とスピードアップを図ることができます。Amazon、続けてASINを選択する)に完了します。ユーザーがAmazonでDRSを利用できるデバイスを購入し、自動的に補充する消耗品を選択します。DRSのクラウドに保存されます。商品がユーザーに発送される前に箱に記載されているデバイスのシリアル番号がスキャンされます。これにより、そのシリアル番号が記載されたSNS通知がデバイスの製造元に送信されます。オプションをクリックします。より利用開始手続きを簡略化するには、次の3つの前提条件があります。箱にそのシリアル番号の1D(または2D)バーコードが印刷されている必要があります。品質管理のため、デバイスモデル検証用の正規表現をAmazonと共有することが推奨されます。Replenishmentサービス(DRS)に追加されたときは必須です。APIに対するリクエストが行われている必要があります。シリアル番号のバーコードデバイスの製造元は、箱にそのデバイスのシリアル番号の情報が入った1D(または2D)バーコードが印刷されていることを確認する責任があります。品質管理のため、および箱の正しいバーコードがスキャンされるように、Amazonはスキャンの一環としてシリアル番号の検証を行います。検証は、デバイスの製造元から提供されたそのデバイスモデル/ASINに対応するシリアルの正規表現に基づきます。製造元は、新しいデバイスモデルがDRSサービスで利用開始になるまでに、シリアルの正規表現とASINを提供することが要求されます。実装このソリューションを連携するには次の3つの手順を実行する必要があります。デバイスが事前登録されているかを識別し、デバイスの登録時にトークン交換のために新しいAPIを呼び出します。事前登録を処理するにはコンパニオンアプリの利用開始手続きのフローで部分的な変更が必要になります。Amazonはコンパニオンアプリとバックエンドの実装を認証し、フルフィルメントセンターのプロセスをテストする必要があります。バックエンドの実装バックエンドアーキテクチャを設計する際には、次の2つのオプションを考慮します。ユーザーがコンパニオンアプリを開き、購入したデバイスに接続すると、必須パラメーターを使用して事前登録エンドポイントへの呼び出しが開始する場合があります。APIエンドポイントと通信するために必要とされる必須のアクセス権限と更新トークンが含まれます。SNS通知を受け取ったときにアクセス権限と更新トークンを要求します。購入されたデバイスが発送されると、deviceRegisteredNotificationを介してそのデバイスの製造元に通知します。この段階で、事前登録エンドポイントが必須パラメーターを使用して呼び出される場合があります。APIエンドポイントを呼び出すのに必要なアクセストークンとリフレッシュトークンが含まれます。このシナリオでは、ユーザーがしばらくの間そのデバイスに接続しない(配送されたデバイスがネットワークに接続されない)場合があり、その場合はアクセストークンの有効期限が切れるため更新する必要があることを意味します。Amazonはオプション1を実装することを強く推奨します。これにより、障害が発生したときやSNS通知を見落としたときにカスタマーエクスペリエンスが悪化するリスクを減らすことができます。Replenishmentサービスによるaccess_tokenの交換を有効にするAPIへのアクセス権限を製造元に付与します。Amazonを確認する手間をなくし、手間を解消します。デバイスの製造元はそのデバイスに接続し、シリアル番号やデバイスモデルなどのデバイスの詳細を抽出するビジネスロジックを管理します。リクエストが行われると、Amazonのシステムは次の操作を行います。API呼び出しを実行するクライアントを認証および許可する。リクエストにあるデバイスがAmazonシステム内でユーザーによって構成されていることを検証する。Replenishmentにサインアップしていることを確認する。小売のチェックアウトフローとフルフィルメントセンターのバーコードスキャンフローは、このAPIを使用したトークン交換が成功するための前提条件です。いずれかのワークフローがスキップされた/失敗した/完了しなかった場合、このAPIは有効な更新トークンをクライアントに返しません。これを達成する方法の例については、API定義セクションをご覧ください。SNS通知の受信DRSに事前登録されたデバイスが発送されると、AmazonはSNSを使用してdeviceRegisteredNotificationを製造元に送信します。この通知には事前登録されたデバイスのシリアル番号が含まれています。SNS通知を受信するには、SNSトピックの作成のドキュメントに従ってインフラストラクチャをセットアップする必要があります。SNS通知(以下を参照)内のserialNumberフィールドは、箱に印刷されているそのデバイスのシリアル番号(DSN)に設定されます。デバイスメーカーはデバイスモデルやシリアル番号のような詳細を、メーカーのデータベースに登録することができます。必要に応じて登録されたSNS通知を保存します。事前登録の通知の例を次に示します。フロントエンドの実装この手順では、既にお使いのコンパニオンアプリにDRSを組み込む手順に関するガイド(iOS、Android、Webサイト(Web))に従っていることを前提としています。事前登録の利点を活用するには、ユーザーがアプリ内のDRSティザーページを確認する前に、事前登録API呼び出しを追加する必要があります。Pseudoコードでは、次のようになります。事前登録が成功しました。サーバーにSSLを用いて保存してください。事前登録対象のデバイスではないと判断し、通常のDRSフローに移行します。認定サーバーとコンパニオンアプリに事前登録を実装した後は、QAチームが事前認定を実行してその実装を検証する必要があります。事前登録の最後に、更新されたコンパニオンアプリを提出してAmazonによる正式な認定を受けることができます。このプロセスを完了する方法については、Amazonの担当者にお問い合わせください。API定義APIは細部を除いて変更されない予定です。細部変更が発生した場合は、DRS事前登録が稼働する前にお知らせします。Bodyパラメーターclient_id:DRSで利用開始手続きを行ったクラウドアプリケーションのLWAクライアントID。client_secret:DRSで利用開始手続きを行ったクラウドアプリケーションのLWAクライアントシークレット。grant_type:「device_preregistration」scope:文字列dash:replenish。標準のLWAフローの場合に「scope」として渡す同じスコープです。scope_data:次のフィールドが含まれるJSONオブジェクト。"device_serial_number":デバイスのシリアル識別子。箱に印刷されているバーコードと一致する同じ識別子です。"device_model":デバイスのモデル識別子。標準のLWAフローの場合に「deviceModel」フィールドとして渡す同じ識別子です。HTTPレスポンス標準のLWAフローであった場合は、/auth/o2/tokenエンドポイントから受け取ったであろう同じデータが含まれるJSONオブジェクト。"access_token":ユーザーのデバイスとアカウント用のアクセストークン。"token_type":返されたトークンの種類。「bearer」である必要があります。"expires_in":アクセストークンが無効になるまでの秒数。"refresh_token":新しいアクセストークンのリクエストに使用できる更新トークン。入力のdevice_modelは利用開始になっていますが、device_serial_numberが事前登録されませんでした。これは、device_serial_numberがAmazonで販売していなかったか、ユーザーが事前登録をスキップしたことが原因の可能性があります。入力のdevice_modelがDRSサービスで利用開始になっていません。LWAの資格情報がdevice_modelの利用開始手続きに使用されたセキュリティプロファイルに属していません。Requestホワイトリストに登録されたデバイスdevice_model:TEST_MODEL_DRS_PREREG_01device_serial_number:TEST_SERIAL_01またはTEST_SERIAL_02リクエストにホワイトリストに登録されたデバイスを有効なクライアントの資格情報と共に使用すると、リクエストが成功します。有効なトークンが返されますが、そのトークンは後続の補充呼び出しには使用できません。無断複写·転載を禁じます。