ウォッチリスト登録削除API


商品をウォッチリストへ登録、またはウォッチリストから削除します。
登録は商品詳細画面等から行い、削除は商品詳細画面またはウォッチリスト一覧画面から行います。
ゲーオクConnectでも同機能を保有しています。


送信契機

商品画面等で商品をウォッチリストに登録またはウォッチリストから削除する場合。
マイオークション画面等でウォッチリストから削除する場合。


送信先URL

(ホスト名)/connect_ja/auctionapi/setwatchlist.php


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
userid 文字 必須 ユーザ識別ID(11桁)
usertoken 文字 必須 ユーザ認証ログイン成功時の token
itemid 数値 必須 出品ID
action 数値 必須 処理
 0:登録
 1:削除

送信時認証方法

ユーザトークン認証
※認証についてはAPI/Webhookについてをご参照ください。


API受信時のゲーオクConnect側での処理

対象ユーザのウォッチリスト登録情報を更新する。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900"
				}
			

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 itemeid 未設定
4 action 未設定または規定値(0または1)以外
11 認証エラー
19 その他のログインエラー
21 対象の出品IDが存在しない
22 既にウォッチリストに登録済み(action が 0 の場合)
31 ウォッチリスト未登録(action が 1ds の場合)

備考

-