サーバーアクセス文書

ユーザー情報検証インタフェース

ユーザー検証インタフェースは、ゲームサーバーがユーザーの正当性を検証するために使用するインターフェースです。ゲームサーバーは、SDKサーバーインタフェイスを呼び出し、返された結果に基づいてユーザーが正当かどうかを確認する必要があります。

Host

• platform.hoolai.com（国内ゲーム）
• platform.hoolai.com（海外ゲーム）

規約

• Http
• https

方法

• POST

パス

• /official/original/validateAccessToken

リクエストヘッダ

• Content-Type: application/json
• X-ACCESS-TOKEN: クライアントログインで取得するaccessToken,()

リクエストパラメータ

パラメータ名	タイプ	説明
productId	Integer/int	ゲーム製品ID, クライアント初期化コールバックパラメータ[gameId]
channel	String/string	ゲームチャンネル（sdk チャンネルkey）, クライアント初期化コールバックパラメータ[channel]
channelId	Integer/int	チャンネルID, クライアント初期化コールバックパラメータ[channelId]
loginUid	Long	現在ログインユーザーid, クライアントログイン成功コールバックパラメータ[uid]

リクエストレスポンス

• 正しいレスポンス

{
    "code": "SUCCESS",
    "sign": "0daa95c4f278a77ceaadb01b62896a12.1650942836",
    "value": "T0s=",
    "desc": "SUCCESS",
    "group": "SUCCESS"
}

• 間違ったレスポンス

{
    "code": "AUTHORIZE_INFO_ERROR",
    "requestId": null,
    "exceptionId": null,
    "desc": "権限授与情報が正しくない",
    "group": "gateway"
}

注意

上記は権限授与情報が正しくない例であり、間違ったレスポンスはそのうちの一つである

支払注文通知インタフェース

このインタフェースは主に、クライアントが支払いを済ませた後に、このインタフェースを通じて注文の支払いが終わったことをゲームに通知し、その後配送操作を実行するために使用されます。（）

規約

• HTTP
• HTTPS

方法

• GET

リクエストパラメータ

パラメータ名	タイプ	例	説明
order_id	String	0C7F3AFA0C404901B4A2CE056F79198C	SDKプラットフォーム注文番号
channel	String	hoolai/hoolaiappstore/xiaomi/xxxx	sdkプラットフォームチャンネルシンボル
product_id	String	1/11/212/xxx	ゲーム製品ID（sdkプラットフォーム）
channel_id	String	12129/12144/xxx	ゲームチャンネルID（sdkプラットフォーム）
uid	String	209879034/248596079/xxxxx	ユーザープラットフォームUID
pay_date	String	2022-05-07 13:25:55	ユーザー支払日時
amount	String	60/99/64800/xxxx	支払金額(よく使われる単位100)、人民元100、米ドル*100など
currency	String	CNY/USD/TWD/EUR/xxxx	よく使われる単位（人民元/米ドル/ユーロ/その他）
callback_info	String	MTExMTE./xxxxx	ゲームパラメータBase64の透過的な送信後（クライアント支払インタフェースにcallback_infoを渡すが、まずはbase64をデコードする必要がある。デコードする前に文字列の‘−' を '+' に変更し、'_' を '/' に変更し、'.' を ‘=' に変更してください (シングルクオートを無視してください)。 注意：callback_infoは最大50桁、文字タイプの制限はない）
sign	String	d02ffcb1e9bb55853e0891577304b58d	すべてのパラメータ（signを含まない）keyは辞典順に並び替えてから連結し、product_key=sdkでキーを提供してMD5署名を行う。例えば：md5(key=value&key=value&key=value...&product_key=xxxx)

ゲームインタフェースレスポンス

レスポンス結果例

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 08 Jun 2015 11:27:44 GMT
Content-Type: text/html;charset=UTF-8
Connection: keep-alive

-レスポンスbodyがok(大文字と小文字を区別しない)の場合は成功を通知し、そうでない場合はsdkが何度も繰り返してトライする。トライ間隔は(秒): 合計13回。13回トライしても成功を通知しなかった場合、sdkは通知を停止し、未通知支払済み注文とマークする。運営はコントロールから手動で配送処理を行う必要がある。

イベント注文通知インタフェース

このインタフェースは、クライアントがCDKなどのイベント参加に成功したあと、このインタフェースを通じてこのイベント注文の報酬配布操作をゲームに通知するために使用されます

規約

• HTTP
• HTTPS

方法

• GET

リクエストパラメータ

パラメータ名	タイプ	例	説明
order_id	String	0C7F3AFA0C404901B4A2CE056F79198C	SDKイベント注文番号
channel	String	hoolai/hoolaiappstore/xiaomi/xxxx	sdkプラットフォームチャンネルシンボル
product_id	String	1/11/212/xxx	ゲーム製品ID（sdkプラットフォーム）
channel_id	String	12129/12144/xxx	ゲームチャンネルID（sdkプラットフォーム）
uid	String	209879034/248596079/xxxxx	ユーザープラットフォームUID
pay_date	String	2022-05-07 13:25:55	ユーザー支払日時
goods_id	String	200001	イベントの報酬番号
role_id	String	1234567	ゲームのキャラID
sign	String	d02ffcb1e9bb55853e0891577304b58d	すべてのパラメータ（signを含まない）keyは辞典順に並び替えてから連結し、product_key=sdkでキーを提供してMD5署名を行う。例えば：md5(key=value&key=value&key=value...&product_key=xxxx)

ゲームインタフェースレスポンス

レスポンス結果例

nginx HTTP/1.1 200 OK
Server: nginx
Date: Mon, 08 Jun 2015 11:27:44 GMT
Content-Type: text/html;charset=UTF-8
Connection: keep-alive

-レスポンスbodyがok(大文字と小文字を区別しない)の場合は成功を通知し、そうでない場合はsdkが何度も繰り返してトライする。トライ間隔は(秒): 合計13回。13回トライしても成功を通知しなかった場合、sdkは通知を停止し、未通知支払済み注文とマークする。運営はコントロールから手動で配送処理を行う必要がある。