SlotStatusエンドポイント
Warning: ここではLegacy APIについて記載しています。新しいAPIについてはこちらを参照してください。
デバイスはスロットの内容が消費されたときに、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は、レスポンス本文に含まれるエラーの性質について可能な限りのフィードバックを提供できるよう努めます。 |
Last updated: Aug 07, 2018