出品取消API


自身が出品した商品の出品を取り消します。
入札がある商品に対しては実行できません。
このAPIを実行した場合は、対象商品を出品ユーザの所持へ戻す必要があります。
出品管理画面等の機能として使用します。
ゲーオクConnectでも同機能を保有しています。


送信契機

マイオークション画面等で、自身の出品を取り消す場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

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

送信時認証方法

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


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

対象の出品を出品終了状態に更新します。


戻り値形式

JSON


戻り値パラメータ

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

▼戻り値サンプル

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

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 itemeid 未設定
11 認証エラー
19 その他のログインエラー
21 対象の出品IDが存在しない
22 ユーザIDの出品ではない
23 入札が1件以上あるため取り消しできない
29 その他の出品取り消し失敗

備考

-