根據您的操作政策，我們提供了一個功能，可以在 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	PlayerID
hive_certification_key	字串	O	認證金鑰（由應用中心發出）
status	字串	O	暫停狀態 `P`: 永久暫停 `B`: 有暫停期限的用戶
block_type	整數	O	暫停類型（必須在 Hive 控制台中註冊：Hive 控制台 > 認證 > 暫停使用 > 註冊類型）
start_date	字串	O	暫停開始日期
end_date	字串	O	暫停結束日期

回應¶

參數	類型	描述
result_code	整數	結果代碼 0: 成功 4000: 參數無效如果暫停開始日期和結束日期的格式不正確如果開始日期晚於結束日期如果當前時間晚於結束日期 4002: 認證密鑰不匹配 4011: 未註冊類型 6000: 無效的appid
result_msg	字符串	有關暫停原因的結果消息

請求範例¶

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"}'

回應範例¶

{
"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	字串	結果訊息

請求範例¶

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"
}