SlotStatusエンドポイント

デバイスはスロットの内容が消費されたときに、SlotStatusエンドポイントを使用してDRSを呼び出し、スロットの現在の状態を報告する必要があります。

パス

/slotStatus/{SLOT_ID}

HTTPメソッド

POST

ヘッダーパラメーター

Authorization: Bearer <ACCESS_TOKEN>
x-amzn-accept-type: com.amazon.dash.replenishment.DrsSlotStatusResult@1.0
x-amzn-type-version: com.amazon.dash.replenishment.DrsSlotStatusInput@1.0

バージョニング

ユーザーに直接影響を及ぼさずにAPIの機能を段階的に更新するためにバージョニングが使用されます。x-amzn-type-versionおよびx-amzn-accept-typeヘッダーは、各呼び出しで送信する必要があります。SlotStatusエンドポイントでは、以下がサポートされています。

x-amzn-type-version: com.amazon.dash.replenishment.DrsSlotStatusInput@1.0
x-amzn-accept-type: com.amazon.dash.replenishment.DrsSlotStatusResult@1.0

リクエスト本文のパラメーター

リクエスト本文では次のデータを渡す必要があります。

パラメーター 説明
expectedReplenishmentDate 商品の予定補充日(ISO 8601形式)。 文字列
remainingQuantityInUnit コンテナーの残量(DeviceCapabilitiesGroupの作成時に指定した測定単位)。 整数
originalQuantityInUnit コンテナーが満量だったときの商品の合計量(DeviceCapabilitiesGroupの作成時に指定した測定単位)。 整数
totalQuantityOnHand 手元にはあるものの、まだ対象デバイスに補充されていない商品の合計量(わかっている場合)。 整数
lastUseDate 特定のスロットから前回商品が消費された日時(ISO 8601形式)。 文字列

リクエスト本文サンプル

{
    "expectedReplenishmentDate" : "2015-12-28T10:00:00Z",
    "remainingQuantityInUnit" : 3.5,
    "originalQuantityInUnit" : 10,
    "totalQuantityOnHand" : 20,
    "lastUseDate" : "2015-12-21T10:00:00Z"
}

レスポンス例

HTTP/1.1 200 OK
x-amzn-type-version: com.amazon.dash.replenishment.DrsSlotStatusResult@1.0

エラーレスポンス

エラー 説明
HTTP/1.1 500 Internal Server Error サーバー内部でエラーが発生したことを示します。
HTTP/1.1 400 Bad Request クライアントエラー: クライアントから渡されたデータが原因でエラーが発生しました(無効なトークンなど)。Amazonは、レスポンス本文に含まれるエラーの性質について可能な限りのフィードバックを提供できるよう努めます。