检查被阻止用户信息

遊戲封鎖用戶檢查 API 在您嘗試從社區、遊戲網頁等使用網頁登錄時，通知您 被暫停的用戶。

基礎¶

	描述
請求 URL	商業版: https://weblogin.withhive.com/block_info 沙盒版: https://sandbox-weblogin.withhive.com/block_info
方法	POST
HTTP 標頭	Content-type: application/json
回應格式	JSON

請求¶

名稱

類型

必填

描述

appid

字串

O

應用程式ID

player_id

整數

O

玩家ID

language

字串

X

這是語言值。如果留空，將自動設置為英文。

ko (韓文)
en (英文)
ja (日文)
zh-hans (簡體中文)
zh-hant (繁體中文)
de (德文)
fr (法文)
ru (俄文)
es (西班牙文)
pt (葡萄牙文)
id (印尼文)
th (泰文)
vi (越南文)
it (義大利文)
tr (土耳其文)
ar (阿拉伯文)

回應¶

名稱	類型	描述	備註
code	整數	結果代碼	100: 成功 2002: 請求主體不存在。 2005: appid 或 player_id 不存在。 2011: appid 無效。 2016: 遊戲無效。 2019: 公司無效。 * 無效: 存在無值或空值。如果您獲得 2016 或 2019，請前往 Hive 控制台 AppCenter 並檢查遊戲或公司的配置。
data	物件	結果數據
data.is_blocked	布林值	用戶在遊戲中是否被封鎖。	true: 被封鎖的用戶 false: 正常用戶
data.status	字串	封鎖狀態	N: 正常 P: 永久封鎖 B: 封鎖一段特定時間
data.start_date	字串	封鎖的開始日期和時間
data.end_data	字串	封鎖的結束日期和時間
data.remaining_date	字串	直到解除封鎖的剩餘天數	這將根據提供的 `language` 值顯示（默認：英文）
data.reason	字串	封鎖原因	這將根據提供的 `language` 值顯示（默認：英文）

請求範例¶

    curl -X POST https://weblogin.withhive.com/block_info
    -H 'Content-Type: application/json'
    -d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "player_id": 20000020208, "language": "ko"}'

回應範例¶

成功（普通用户）¶

    {
            "code": 100,
            "data": {
                    "is_blocked": false,
                    "status": "N",
                    "start_date": null,
                    "end_date": null,
                    "remaining_date": null,
                    "reason": null
            }
    }

成功（用戶被封鎖特定時間）¶

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "B",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "2023-10-10 14:42:17",
                    "remaining_date": "90 day(s)",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

成功（用戶已永久封鎖）¶

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "P",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "9999-12-31 00:00:00",
                    "remaining_date": "Permanent",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

失敗¶

    {
            "code": 2002,
            "data": {}
    }