ストア
store > modify_cart
ショッピングカートの変更:商品の追加、削除、またはカートを空にします。
リクエストの構築
リクエストURLとGET変数
リクエスト固有のGET変数
| 変数 | 値 | 説明 |
|---|---|---|
| go | store | APIセクション |
| do | modify_cart | APIアクション |
| iq | User ID | ユーザーID |
リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。
https://....../api.php?go=store&do=modify_cart&iq={user_id}&{required information}
POST変数
以下のPOST変数は必須です。
| 変数 | 値 | 説明 |
|---|---|---|
| cartAction | (string) Operation Type | 利用可能な値:"add"(商品の追加), "remove"(商品の削除), "empty"(カートを空にする) |
| productID | (int) Product ID | "cartAction=add"または"cartAction=remove"の場合は必須です。 |
| productQty | (int) Quantity | クレジットや寄付など商品タイプで数量が必要な場合にのみ必要。デフォルト値:1 |
応答例
リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・ok
{
"ok":"Cart action was performed"
}
リクエストにハッシュが指定されていない場合など、リクエストが失敗した場合のレスポンス
{
"error" : "REQUEST_ERROR",
"error_long" : "Missing signature"
}
このリクエストは以下のエラーを返す可能性があります。
・REQUEST_ERROR | Invalid User ID
ユーザーIDが指定されていないか無効、もしくは1未満です。
・REQUEST_ERROR | Invalid cart action
アクションが指定されていないか、許可されているものと異なります。
・REQUEST_ERROR | Invalid or missing product ID
商品IDが指定されていないか無効、もしくは1未満です。
・REQUEST_ERROR | Invalid product quantity
数量が指定されていないか無効、もしくは0以下です。
・ERROR | User not found
IDに該当するユーザーが見つかりません。
・CART_ACTION_ERROR | Cant perform actions on the cart because there is acurrent order
進行中の注文がある為アクションは実行されませんでした。
その他のエラー内容に関しては一般的なエラーメッセージを確認してください。
PHPサンプルコード
GETおよびPOSTデータを準備します。
// GET変数 $GET_VARS = array( "go" => "store", "do" => "modify_cart", "iq" => "2" ); // POST変数 $POST_VARS = array( "cartAction" => "add", "productID" => 79, "productQty" => 1 );