入札管理API


ユーザが入札または落札した商品の概要の一覧をゲーム単位で取得します。
ゲーオクConnectでも同機能を保有しています。


送信契機

マイオークション画面等で、ユーザが入札または落札した商品一覧を表示させる場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
userid 文字 必須 ユーザ識別ID(11桁)
usertoken 文字 必須 ユーザ認証ログイン成功時の token
gameid 文字 必須 ゲームID(ゲーオクConnectが発行したもの)
status 数値 - 表示状態(省略時は 0)
 0:入札中
 1:落札成功
 2:落札失敗

送信時認証方法

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


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

対象ユーザが入札した商品の一覧を返します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
itemcnt 入札商品数
item 商品情報(配列) itemcnt の数だけ要素有り
− itemid 出品ID
− itemname 出品タイトル
− authorid 出品者ID
− authorname 出品者名(ニックネーム)
− imgurl 出品画像URL
− startdate 開始日時(YYYY/MM/DD HH:MM:SS +0000 の形式)
− enddate 出品中は終了予定日時、出品終了は終了日時(YYYY/MM/DD HH:MM:SS +0000 の形式)
− startprice 開始価格
− nowprice 最高入札額(落札成功/失敗の時は最終価格)
− biddername 最高入札者名(ニックネーム)
− bidprice 自分の最後の入札額(落札成功時の時は nowprice と同額)
− bidcnt 入札数
− tradestatus 取引状況
 0:出品中
 1:落札者による支払い待ち
 2:落札者の支払い完了
   ※ゲーム側でのアイテム移動後、取引完了API で確定する必要あり
 3:取引完了
 4:支払い期限切れによる取引不成立
 5:落札不成立
 9:内部データエラー(要問合せ)

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "itemcnt":5,
				  "item":[
				    {
				      "itemid":145,
				      "itemname":"\u30B5\u30F3\u30D7\u30EB\u5546\u54C1",
				      "authorid":"12345678901",
				      "authorname":"\u51FA\u54C1\u8005",
				      "imgurl":"https:\/\/xxxxxxxx\/connect_ja\/xxxxxxxx\/xxxx.png",
				      "startdate":"2015/08/01 09:23:41 +0900",
				      "enddate":"2015/08/31 23:59:59 +0900",
				      "startprice":1500,
				      "nowprice":2100,
				      "biddername":"\u5165\u672D\u8005",
				      "bidprice":1800,
				      "bidcnt":3
				      "tradestatus":""
				    },
				    {
				      ・
				      ・
				      ・
				    },
				    {
				      ・
				      ・
				      ・
				    }
				  ]
				}
			

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 gameid 未設定
4 status が 0 , 1 , 2 以外
11 認証エラー
19 その他のログインエラー
21 gameid 該当無し

備考

出品者IDは内部的に出品者を特定する為だけに使用し、表示は出品者名(ニックネーム)を使用しなければならない。