根据您的操作政策，我们提供了一项功能，可以在 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	字符串	是	应用ID
player_id	整数	是	玩家ID
hive_certification_key	字符串	是	认证密钥（由应用中心颁发）
status	字符串	是	暂停状态 `P`: 永久暂停 `B`: 有暂停期限的用户
block_type	整数	是	暂停类型（必须在 Hive 控制台注册：Hive 控制台 > 认证 > 暂停使用 > 注册类型）
start_date	字符串	是	暂停开始日期
end_date	字符串	是	暂停结束日期

响应¶

参数	类型	描述
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 头	Content-type: application/json ISCRYPT: 0
响应格式	JSON

请求¶

字段	类型	必需	描述
appid	字符串	是	应用ID
player_id	整数	是	玩家ID
hive_certification_key	字符串	是	认证密钥（在应用中心颁发）

响应¶

字段	类型	描述
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"
}