ログインAPI


ユーザのメールアドレスとパスワードを認証し、ゲーオクConnectにログインします。
ログインに成功した場合はユーザトークンを返します。
ユーザをゲーオクConnectにログインさせる場合に使用します。
ゲーオクConnectでも同機能を保有しています。
ゲーム側での実装は必須になります。


送信契機

ログイン画面等で、ゲーオクConnectに登録済みのユーザを、ゲーオクConnectにログインさせる場合。


送信先URL

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


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
useremail 文字 必須 メールアドレス(アカウントID)
password 文字 必須 パスワード
gameid 文字 必須 ゲームID(ゲーオクConnect発行のもの)

送信時認証方法

署名認証
※認証についてはAPI/Webhookについてをご参照ください。


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

メールアドレスとパスワードが一致しているユーザが登録されているかを確認し、登録されている場合はユーザトークンおよび登録情報を返します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
access_token 新規発行のアクセストークン
userid ユーザ識別ID(11桁)
nickname ユーザニックネーム

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "access_token":"A0b1C2d3E4f5G6h7I8.j9K0l1M2n3O4p5Q6r7S8t9U0v1W2x3Y4z5",
				  "userid":"01234567890",
				  "nickname":"\u306B\u3063\u304F\u306D\u30FC\u3080"
				}
			

戻り値エラーコード

エラーコード 原因
1 useremail 未設定
2 password 未設定
3 gameid 未設定
4 gameid が存在しないゲームID
11 ユーザー未登録
19 その他のログインエラー
31 Signature 未設定
32 認証失敗

備考

ユーザIDとユーザトークンは他のAPI利用時に必要となるため、ユーザに紐付けて保管する必要がある。