Inc.API/WebhookについてゲーオクConnectでは、ユーザ情報とオークション情報をゲームと連動できるよう、APIとWebhookを提供します。これらをゲームに実装することにより、ゲーオクConnectで操作できることは一部の機能を除きゲーム内から操作できるようになります。以降のページで仕様を掲載しますので、仕様に基づいた実装をお願いします。APIとWebhookの定義ゲーオクConnectでは、APIとWebhookを次の意味で定義します。ゲーム側からゲーオクConnectへパラメータを送付し、情報を取得したりゲーオクConnect側で処理を実行させたりする場合に使用します。送信時は指定のURLに指定のパラメータをPOST方式で送信します。戻り値はJSONで送信します。ゲーオクConnectからゲーム側へパラメータを送付し、ゲーム側で処理を実行させる場合に使用します。送信時は指定のURLに指定のパラメータをPOST方式で送信します。戻り値はJSONで送信します。$result_encode;認証API/Webhookには、通信が不正ではないことを確認するため認証を付ける場合があります。使用する認証は以下の2種類です。どの認証を使用するかは各API/Webhookの詳細をご参照ください。ゲーオクConnectが発行する「ゲームKey」を使って、ゲーオクConnectとゲーム側だけが認識できる文字列を署名として送信する方式の認証です。POST送信するデータとゲームKeyを連結させた文字列をSHA256でハッシュ値を生成し、そのハッシュ値を「Signature」パラメータとしてHeaderに付加して送信します。受信した側は、同様にデータとゲームKeyを連結させた文字列をSHA256でハッシュ値を生成し、そのハッシュ値とHeaderのSignatureの値とを比較し、一致していれば正しい通信であると判断します。APIを送信する際、ゲーオクConnectが発行するユーザトークンを併せて送信する方式の認証です。ユーザトークンは、ゲーム側がログインAPIを送信した際、正常にログインできた場合に戻り値としてゲーオクConnectが発行します。ゲーム側ではこのユーザトークンをログインしたユーザIDと紐付けて保存し、その後のAPIで使用します。APIでユーザIDとユーザトークンが認証できた場合は、正しい通信であると判断します。API/Webhook用語定義ゲーオクConnectではAPI/Webhookに関連する共通用語を以下の通り定義します。ゲーオクConnectのサーバのホスト名を指します。各APIの送信先URLには「ホスト名」と記載しています。開発を申し込んでいただいた場合に実際のホスト名をお伝えします。ユーザが所持するメールアドレスであり、ユーザがゲーオクConnectにログインするために必要なIDです。不正なメールアドレスでは利用できないような設計をする必要があります。メールアドレスと一対になる、ユーザがゲーオクConnectにログインするために必要なパスワードです。ゲーオクConnectでは暗号化して管理するため把握はできません。ユーザを識別するための11桁のIDです。APIではユーザIDをキーとしてユーザを識別します。ユーザは使用しません。ユーザを新規登録した場合に発行されます。ユーザIDと一対になる、ユーザIDが不正なものではないことを認証するための文字列です。一部のAPIではユーザIDとユーザトークンをセットで送信し、認証を行います。ユーザは使用しません。ユーザがログインする度に発行されます。不正使用を防ぐため、部外者に漏れないように管理する必要があります。ゲーオクConnectがゲームごとに発行する、署名認証に必要な文字列です。API/Webhookが不正な通信ではないことを証明するためのものなので、部外者に漏れないように管理する必要があります。発行後に変更を希望する場合はお問い合わせください。ゲーオクConnectがゲームごとに発行する、ゲームを識別するための文字列です。不正使用を防ぐため、部外者に漏れないように管理する必要があります。発行後に変更を希望する場合はお問い合わせください。ゲーオクConnectがゲームごとに発行する、ゲーム内アイテムのカテゴリを識別するための文字列です。不正使用を防ぐため、部外者に漏れないように管理する必要があります。発行後に変更を希望する場合はお問い合わせください。商品落札後、落札したユーザが落札代金の決済を行うことを指します。アイテムの取引が完了後に、ゲーオクConnectが出品したユーザへ振込を行うため、仮としています。仮支払いはゲーオクConnect内でしか行えません。後述の方法でゲーオクConnectで決済を行うよう案内してください。API非提供機能ゲーオクConnectが保有する機能のうち、支払い機能はAPIとして提供していません。商品落札後に落札者に支払いを行わせる場合は、以下のゲーオクConnectのURLにリダイレクトし、ログイン後に決済を行うよう誘導してください。開発〜リリースのフローお問い合わせAPI/WebhookについてAPI/Webhook一覧ユーザ登録確認APIユーザ新規登録APIログインAPIユーザ情報取得APIメールアドレス変更APIパスワード変更APIユーザ情報変更APIパスワード再設定API出品一覧取得API商品詳細取得API商品コメントAPI出品管理API出品API出品取消API取引終了通知Webhook入札管理API入札APIウォッチリスト取得APIウォッチリスト登録削除API仮支払い完了通知Webhook取引確定API評価取得API評価API。