停權 API 指南¶

根據您的操作政策，我們提供了一個功能，可以在 Hive 伺服器上設置帳戶暫停。通過在 Hive 控制台中預先註冊暫停類型，您可以區分並註冊永久暫停的用戶和具有臨時暫停期限的用戶。此外，您可以更改已註冊用戶（按 PlayerID 區分）的暫停類型和暫停期限。

基礎¶

請求 URL	生產環境: https://auth.qpyou.cn/game/block/set 沙盒環境: https://sandbox-auth.qpyou.cn/game/block/set
方法	POST
HTTP 標頭	內容類型: application/json ISCRYPT: 0
回應格式	JSON

請求¶

參數	類型	必需	描述
appid	字串	O	AppID
player_id	整數	O	玩家 ID
hive_certification_key	字串	O	認證金鑰（由應用中心發出）
status	字串	O	暫停狀態 `P`: 永久暫停 `B`: 有暫停期限的用戶
block_type	整數	O	停權類型編號必須先在 [Hive 主控台 > 認證 > 停權 > 類型註冊] 中註冊。
start_date	字串	O	暫停開始日期
end_date	字串	O	暫停結束日期
skip_blocked	Boolean	X	若以 `skip_blocked=true` 發送請求，當既有封鎖資料已存在時，不會變更封鎖資料，並返回 `result_code=0`。
did	Integer	X	這是在安裝遊戲 App 時建立的遊戲 App 識別碼。用於識別相同類型的遊戲 App。於 SDK 初始化時，若接收並傳遞新核發或既有值，則會驗證該裝置的登入紀錄。

回應¶

參數	類型	描述
result_code	整數	結果代碼 0: 成功 4000: 參數無效如果暫停開始日期和結束日期的格式不正確如果開始日期晚於結束日期如果當前時間晚於結束日期 4002: 認證密鑰不匹配 4011: 未註冊類型 4013: `did` 登入紀錄驗證失敗在登出狀態下無法驗證 6000: 無效的appid
result_msg	字符串	有關暫停原因的結果消息

期間限制停權註冊請求範例¶

註冊期間限制停權使用者時，請將 status 指定為 B，並一併傳遞 start_date、end_date。

curl -X POST https://auth.qpyou.cn/game/block/set \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "status" : "B", "block_type" : 18, "start_date" : "2024-06-03 00:00:00", "end_date" : "2024-06-30 23:59:59", "skip_blocked" : true, "did" : 2000000}'

期間限制停權註冊成功回應範例¶

請求正常處理後，會返回 result_code 為 0，且 result_msg 為 SUCCESS。

{
"result_code": 0,
"result_msg": "SUCCESS"
}

解除用戶的暫停¶

直接在 Hive 伺服器上解除特定帳戶的暫停。

基礎¶

請求 URL	生產環境: https://auth.qpyou.cn/game/block/delete 沙盒環境: https://sandbox-auth.qpyou.cn/game/block/delete
方法	POST
HTTP 標頭	內容類型: application/json ISCRYPT: 0
響應格式	JSON

請求¶

欄位	類型	必要	描述
appid	字串	O	AppID
player_id	整數	O	PlayerID
hive_certification_key	字串	O	認證金鑰（在應用中心發行）

回應¶

欄位	類型	描述
result_code	整數	0: 成功 2002: 使用者未被暫停 4000: 參數無效 4002: 認證金鑰不匹配 6000: 無效的appid
result_msg	字串	結果訊息

解除停權請求範例¶

解除特定帳號的停權時，請依下列請求格式一併傳遞 appid、player_id、hive_certification_key。

curl -X POST https://auth.qpyou.cn/game/block/delete \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"}'

解除停權成功回應範例¶

請求正常處理後，會返回 result_code 為 0，且 result_msg 為 SUCCESS。

{
   "result_code": 0,
   "result_msg": "SUCCESS"
}