出品一覧取得API


出品された商品の概要の一覧をゲーム単位で取得します。
オークションホーム画面や出品一覧画面等で使用します。
ゲーオクConnectでも同機能を保有しています。


送信契機

出品一覧画面等で商品一覧を表示させる場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
gameid 文字 必須 ゲームID(ゲーオクConnectが発行したもの)
subcatid 文字 - サブカテゴリID(省略時は全てのサブカテゴリが対象)
status 数値 - 出品状態(省略時は0)
 0:出品中
 1:出品終了
search 文字 - 検索文字列(対象は出品タイトルのみ)

送信時認証方法

なし


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

登録されている出品商品情報を返します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
itemcnt 出品商品数
item 商品情報(配列) itemcnt の数だけ要素有り
− itemid 出品ID
− itemname 出品タイトル
− subcatid 出サブカテゴリID
− subname サブカテゴリ名
− imgurl 出品画像URL
− content 出品説明
− nowprice 現在価格
− enddate 出品中は終了予定日時、出品終了は終了日時(YYYY/MM/DD HH:MM:SS +0000 の形式)
− bidcnt 入札数
− commcnt コメント数

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "itemcnt":5,
				  "item":[
				    {
				      "itemid":145,
				      "itemname":"\u30B5\u30F3\u30D7\u30EB\u5546\u54C1",
				      "subcatid":"game-item",
				      "subname":"\u30A2\u30A4\u30C6\u30E0",
				      "imgurl":"https:\/\/xxxxxxxx\/connect_ja\/xxxxxxxx\/xxxx.png",
				      "content":"\u5546\u54C1\u306E\u8A73\u7D30\u8AAC\u660E\u3067\u3059",
				      "nowprice":1500,
				      "enddate":"2015/08/31 13:57:07 +0900",
				      "bidcnt":3,
				      "commcnt":2
				    },
				    {
				      ・
				      ・
				      ・
				    },
				    {
				      ・
				      ・
				      ・
				    }
				  ]
				}
			

戻り値エラーコード

エラーコード 原因
1 gameid が未設定
2 status が 0 または 1 以外
21 gameid 該当無し
22 subcatid 該当無し

備考

-