商品詳細取得API


商品の出品情報や入札状況、コメントやステータス等を商品単位で取得します。
ゲーオクConnectでも同機能を保有しています。


送信先URL

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


送信契機

出品一覧画面等で、各商品の詳細情報を表示させる場合。


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
itemid 数値 必須 出品ID
userid 文字 - ユーザ識別ID(11桁)
※ウォッチリスト登録状況を取得する場合は必須
usertoken 文字 - ユーザ認証ログイン成功時の token
※userid ありの場合は必須

送信時認証方法

ユーザトークン認証(userid ありの場合のみ)
※認証についてはAPI/Webhookについてをご参照ください。


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

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


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
itemname 出品タイトル
authorid 出品者ID
authorname 出品者名(ニックネーム)
imgurl 出品画像URL
content 出品説明
subcat サブカテゴリID
subname サブカテゴリ名
evaluate 出品者の評価(0.0~5.0)
evacnt 評価件数
nowprice 現在価格(入札がある場合は bids[0]->bidprice と同じ)
biddername 入札者名(入札が無ければ" ")(入札がある場合は bids[0]->biddername と同じ)
incprice 入札額の最低上げ幅
bidcnt 入札件数
bids 入札情報(配列) bidcnt の数だけ要素有り(最新の入札順)
− bidderid 入札者ID
− biddername 入札者名(ニックネーム)
− bidprice 入札価格
− bidtime 入札日時(YYYY/MM/DD HH:MM:SS +0000 の形式)
buynow 即決価格
realize 落札成立条件(最低落札価格)の達成状況
 true:達成
 false:未達
enddate 出品中は終了予定日時、出品終了は終了日時(YYYY/MM/DD HH:MM:SS +0000 の形式)
trade 出品状態
 0:出品中
 1:落札
 2:期限切れまたは取り消しにより落札非成立
tradestatus 取引状況
 0:出品中
 1:落札者による支払い待ち
 2:落札者の支払い完了(仮支払い)
   ※ゲーム側でのアイテム移動後、取引完了API で確定する必要あり
 3:取引完了
 4:支払い期限切れによる取引不成立
 5:落札不成立(落札期限切れまたは出品取り消しによる)
 9:内部データエラー(要問合せ)
commcnt コメント件数
comms コメント情報(配列) commcnt の数だけ要素有り(最新のコメント順)
− commname 投稿者名(ニックネーム)
− commtime 投稿日時(YYYY年MM月DD日 HH:MM の形式)
− commtext コメントテキスト
watchlist ウォッチリストへの登録状況
 true:登録済み
 false:未登録
※userid / usertoken を指定した時のみ有効

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "itemname":"\u30B5\u30F3\u30D7\u30EB\u5546\u54C1",
				  "authorid":"12345678901",
				  "authorname":"\u51FA\u54C1\u8005",
				  "imgurl":"https:\/\/xxxxxxxx\/connect_ja\/xxxxxxxx\/xxxx.png",
				  "content":"\u5546\u54C1\u306E\u8A73\u7D30\u8AAC\u660E\u3067\u3059",
				  "subcat":"game-item",
				  "subname":"\u30A2\u30A4\u30C6\u30E0",
				  "evaluate":3.5,
				  "evacnt":4,
				  "nowprice":3100,
				  "biddername":"\u5165\u672D\u8005",
				  "incprice":100,
				  "bidcnt":2,
				  "bids":[
				    {
				      "bidderid":"34567890123",
				      "biddername":"\u5165\u672D\u8005",
				      "bidprice":3100,
				      "bidtime":"2015/11/20 08:19:07 +0900"
				    },
				    {
				      "bidderid":"23456789012",
				      "biddername":"\u524D\u306E\u5165\u672D\u8005",
				      "bidprice":3000,
				      "bidtime":"2015/11/15 21:01:49 +0900"
				    }
				  ],
				  "buynow":"50000",
				  "realize":true,
				  "enddate":"2015-08-31 23:59:59",
				  "trade":1,
				  "tradestatus":1,
				  "commcnt":2,
				  "comms":[
				    {
				      "commname":"\u3068\u304A\u308A\u3059\u304C\u308A",
				      "comtime":"2015/11/20 08:20:15 +0900",
				      "commtext":"\u3053\u306E\u30A2\u30A4\u30C6\u30E0\u306E\u6B8B\u8010\u4E45\u5EA6\u3092\u6559\u3048\u3066\u304F\u3060\u3055\u3044\u3002"
				    },
				    {
				      "commname":"\uff26\u306e\u4eba",
				      "comtime":"2015/11/15 21:02:03 +0900",
				      "commtext":"\u672A\u4F7F\u7528\u3067\u3059\uFF01"
				    }
				  ],
				  "watchlist":1
				}
			

戻り値エラーコード

エラーコード 原因
1 itemid が未設定
2 usertoken 未設定
※userid ありの場合のみ
11 認証エラー
19 その他のログインエラー
21 対象商品無し

備考

userid / usertoken を指定すれば、ウォッチリストに登録済みかどうかの情報を取得できる。