出品API


商品を出品します。
出品した商品は、出品ユーザの所持数から減らす必要があります。
ゲーオクConnectは本機能を保有していないため、出品は必ずゲーム側から行う必要があります。
ゲーム側での実装は必須になります。


送信契機

出品画面等でゲームアイテムをオークションに出品する場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
userid 文字 必須 ユーザ識別ID(11桁)
usertoken 文字 必須 ユーザ認証ログイン成功時の token
itemname 文字 必須 出品タイトル(30文字以内)
content 文字 必須 出品説明(200文字以内)
gameid 文字 必須 ゲームID(ゲーオクConnectが発行したもの)
subcatid 文字 必須 サブカテゴリID(ゲーオクConnectが発行したもの)
enddate 文字 必須 終了日時(YYYY/MM/DD HH:MM:SS の形式)
startprice 数値 必須 開始価格(500〜490,000円)
lowestbid 数値 - 最低落札価格(開始価格〜500,000円、省略時は開始価格と同一)
入札があっても最低落札価格未満の入札額では落札は成立しない、他のユーザには公開されない価格
incprice 数値 - 入札額の最低上げ幅(入札単位、1〜10,000円、省略時は1)
buynow 数値 - 即決価格(最低即決価格(※)〜500,000円、省略時は最低即決価格(※)に設定)
※最低即決価格について
最低落札価格が開始価格より大きい、かつ、入札額の最低上げ幅が最低落札価格と開始価格の差より小さい場合は、最低即決価格は最低落札価格。
それ以外の場合は、最低即決価格は開始価格と入札額の最低上げ幅の合計値。
imgfile FILE - 画像情報('@'+画像ファイルパス/ファイル名)

送信時認証方法

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


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

出品情報をDBに登録し、出品IDを返します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
配列になっており、1〜29 のエラーは同時にチェックされエラーの数だけ格納される
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
itemid 出品ID(成功時のみ)

▼戻り値サンプル

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

				または
				
				{
				  "rcode":-1,
				  "errorcode":[5,7,22],
				  "apitime":"2015/08/15 10:24:46 +0900"
				}
			

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 itemname 未設定
4 content 未設定
5 gameid 未設定
6 subcatid 未設定
7 enddate 未設定
8 startprice 未設定
11 認証エラー
19 その他のログインエラー
21 enddate が日時として無効
22 enddate が現在日時より過去
23 startprice が 制限値外 または整数ではない
24 lowestbid が startprice 未満 または 制限値外 または整数ではない
25 incprice が 制限値外 または整数ではない
26 buynow が lowestbid 未満 または 制限値外 または 整数ではない または 最低即決価格未満
27 itemname が規定値(30文字以内)ではない
28 content が規定値(200文字以内)ではない
31 gameid が存在しないゲームID
32 subcatid が存在しないサブカテゴリID
33 イメージファイル登録失敗
39 その他の出品データ登録失敗

備考

画像情報がFILE形式でない場合は、画像情報無しとして処理する。