入札API


出品中の商品に対し入札または落札を行います。
入札があった場合、出品者に通知されます。
入札額を高値更新した場合は、高値更新されたユーザにも通知されます。
ゲーオクConnectでも同機能を保有しています。


送信契機

商品画面等で入札または即落札を行う場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
userid 文字 必須 ユーザ識別ID(11桁)
usertoken 文字 必須 ユーザ認証ログイン成功時の token
itemid 数値 必須 出品ID
buynow 数値 - 即決フラグ(省略時は 0)
 0:即決無し
 1:即決落札
bidval 数値 - 入札額
※buynow が 1 の場合のみ省略可能

送信時認証方法

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


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

商品の入札情報を更新します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
beforeBidderID 直前の入札者ID
beforeBidderName 直前の入札者名(ニックネーム)

▼戻り値サンプル

				{
				  "rcode":-1,
				  "errorcode":21,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "beforeBidderID":"01234567890",
				  "beforeBidderName":"\u5165\u672D\u8005"
				}
			

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 itemeid 未設定
4 buynow が 0 または 1 以外
5 bidval 未設定(即決無しの場合のみ)
6 bidval が整数以外(即決無しの場合のみ)
11 認証エラー
19 その他のログインエラー
21 対象の出品IDが存在しない
22 自分の出品
31 入札額不正(入札が成立しない値 ※入札額が、現在の入札額と入札単位の合計より小さい場合)
32 出品不正により入札不可
41 出品終了(期限切れや出品取り消しなど)
49 入札データ登録失敗

備考

直前の入札者がいなければ、入札者ID/名前は ’ ’ となる。
(入札者にとってこの情報は無意味であるが、他の入札によって権利を失った事を通知するなどの機能をゲームサーバに持たせる場合に使える情報である)