跳轉至

檢查遊戲停權使用者

當使用者在社群、網頁等位置嘗試進行網頁登入時，此 API 用於確認被阻止進入應用程式的使用者。


請求 URL

正式 URL https://auth.qpyou.cn/v2/game/block/get
沙盒 URL https://sandbox-auth.qpyou.cn/v2/game/block/get
HTTP 方法 POST
Content-Type application/json
資料格式 JSON


請求標頭

欄位名稱 說明 類型 必填
X-Access-Token 用於應用程式伺服器認證的 OAuth 2.0 Access Token
（請參閱 發行 OAuth Token）		 String Y
ISCRYPT 資料是否加密（0 = 不加密）（必須傳遞 0） Integer Y


請求本文

欄位名稱 說明 類型 必填
appid App ID String Y
player_id Player ID Integer Y
language Language value. If omitted, English is used by default.
  • ko (Korean)
  • en (English)
  • ja (Japanese)
  • zh-hans (Simplified Chinese)
  • zh-hant (Traditional Chinese)
  • de (German)
  • fr (French)
  • ru (Russian)
  • es (Spanish)
  • pt (Portuguese)
  • id (Indonesian)
  • th (Thai)
  • vi (Vietnamese)
  • it (Italian)
  • tr (Turkish)
  • ar (Arabic)
  • tl (Filipino)
String N


請求範例

{"appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal","player_id":20000020208,"language":"ko"}


回應本文

欄位名稱 說明 類型
result_code 回應代碼 詳情 Integer
result_msg 結果訊息 String
token_validation JWT 驗證結果（JWT 驗證錯誤） Object
token_validation.result_code JWT 驗證結果代碼 Integer
token_validation.result_msg JWT 驗證結果訊息 String
data 結果資料 Object
data.is_blocked Whether access is suspended
  • true: suspended user
  • false: normal user
 Boolean
data.status Suspension status
  • N: normal user
  • P: permanently suspended user
  • B: user suspended for a specified period
 String
data.start_date Suspension start date String
data.end_date Suspension end date String
data.remaining_date Remaining suspension period (returned in the requested language; default: English) String
data.reason Suspension reason (returned in the requested language; default: English) String

回應代碼

Code value 說明
0 成功
2499 JWT 驗證失敗（請參閱 token_validation）
4000 無效參數
6000 無效 appid


回應範例

成功 (normal user)

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":false,"status":"N","start_date":null,"end_date":null,"remaining_date":null,"reason":null}}

成功 (user suspended for a specified period)

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":true,"status":"B","start_date":"2024-05-15 10:00:00","end_date":"2024-06-30 23:59:59","remaining_date":"27d 5hr 8min","reason":"Temporary Restriction (Retrieve game money)"}}

成功 (permanently suspended user)

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":true,"status":"P","start_date":"2024-05-15 10:00:00","end_date":"9999-12-31 00:00:00","remaining_date":"Permanent","reason":"Temporary Restriction (Retrieve game money)"}}

JWT validation failure

{
  "result_code": 2499,
  "result_msg": "JWT validation failed. See token_validation for details.",
  "token_validation": {
    "result_code": 2408,
    "result_msg": "The access token is expired. Please refresh your token."
  }
}

失敗

{"result_code":4000,"result_msg":"Request has invalid format.","token_validation":{"result_code":0,"result_msg":"success"},"data":"player_id"}
Note

JWT 驗證失敗時，可在 token_validation 欄位中查看詳細錯誤資訊。詳情請參閱 JWT 驗證錯誤代碼。