Skip to content

Check blocked users information

The Game blocked user check API/b> informs you of the suspended users when attempting to log in using a web login from a community, game web page, etc.

Basics

  Description
Request URL
  • Commercial: https://weblogin.withhive.com/block_info
  • Sandbox: https://sandbox-weblogin.withhive.com/block_info
Method POST
HTTP Header Content-type: application/json
Response Format JSON

Request

Name Type Required Description
appid String O the AppID
player_id Integer O the PlayerID
language String X

This is the language value. If left empty, it is automatically set to English.

  • ko (Korean)
  • en (English)
  • ja (Japanese)
  • zh-hans (Chinese Simplified)
  • zh-hant (Chinese Traditional)
  • de (German)
  • fr (French)
  • ru (Russian)
  • es (Spanish)
  • pt (Portuguese)
  • id (Indonesian)
  • th (Thai)
  • vi (Vietnamese)
  • it (Italian)
  • tr (Turkish)
  • ar (Arabic)

Response

Name Type Description Notes
code Integer Result Code
  • 100: Success
  • 2002: the request body does not exist.
  • 2005: the appid or player_id does not exist.
  • 2011: the appid is not valid.
  • 2016: the game is not valid.
  • 2019: the company is not valid.

* not valid: No value or a null value exists. If you get 2016 or 2019, go to Hive Console AppCenter and check out the game or the company configurations.
data Object Result data
data.is_blocked Boolean Whether the user is blocked in the game or not.
  • true: blocked user
  • false: normal user
data.status String Blocking status
  • N: normal
  • P: permanently blocked
  • B: blocked for a specific period of time
data.start_date String The start date and time of blocking
data.end_data String The end date and time of blocking
data.remaining_date String The remaining days until the blocking is released This will be shown following the provided `language` value(default: English)
data.reason String Reasons for blocking This will be shown following the provided `language` value(default: English)

Request examples

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

Response examples

Success (normal user)

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

Success (a user blocked for a specific period of time)

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

Success (a user permanently blocked)

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

Failure

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