ดึงข้อมูลผู้ใช้ด้วย API การตรวจสอบสิทธิ์

การดึงข้อมูลผู้ใช้ผ่าน API การตรวจสอบสิทธิ์ เป็น API ที่ถูกเรียกใช้เมื่อจำเป็นต้องตรวจสอบข้อมูลผู้ใช้แยกต่างหากหลังจากที่ทำการเข้าสู่ระบบเว็บเสร็จสิ้น.

ส่งคืนข้อมูลผู้ใช้ที่ตรงกับ IdP โดยใช้ค่าตอบกลับ appid, idp_index, และ idp_user_id จาก API การตรวจสอบการเข้าสู่ระบบและการดึงข้อมูลผู้ใช้

URL การร้องขอ

สภาพแวดล้อม	URL
การผลิต	https://auth.qpyou.cn/game/player/get-playerid
การผลิต	https://auth.globalwithhive.com/game/player/get-playerid
Sandbox	https://sandbox-auth.qpyou.cn/game/player/get-playerid
วิธีการ HTTP	POST
ประเภทเนื้อหา	application/json

Note

Authentication v4 ถูกออกแบบมาเพื่อสร้างสภาพแวดล้อมที่กระจายตัวในกรณีที่เกิดความล้มเหลวหรือปัญหาการสื่อสารเครือข่าย หากความล้มเหลวหรือความผิดปกติในการสื่อสารเครือข่ายเกินเวลาที่กำหนดสำหรับเซิร์ฟเวอร์เกม สภาพแวดล้อมที่กระจายตัวจะต้องถูกเรียกใช้

ส่วนหัวคำขอ

ชื่อฟิลด์	ประเภท	คำอธิบาย	จำเป็น
ISCRYPT	จำนวนเต็ม	ว่าข้อมูลถูกเข้ารหัสหรือไม่ (0: ไม่เข้ารหัส)	ใช่

เนื้อหาคำขอ

ชื่อฟิลด์	ประเภท	คำอธิบาย	จำเป็น
appid	String	รหัสแอป	Y
idp_index	Integer	ดัชนี IdP 1: HIVE 2: FACEBOOK 3: GOOGLE 9: APPLE 10: LINE 14: GOOGLE_PLAY_GAMES 18: STEAM 19: X	Y
idp_user_id	String	รหัสประจำตัวที่ไม่ซ้ำของ IdP	Y
hive_certification_key	String	รหัสการรับรองของ Hive (Hive Console > App Center > Project Management > Game Details > Basic Information > Hive Certification Key)	Y

ตัวอย่างเนื้อหาคำขอ

{
  "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common",
  "idp_index": 1,
  "idp_user_id": "68101398",
  "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}

เนื้อหาการตอบกลับ

ชื่อฟิลด์	ประเภท	คำอธิบาย	หมายเหตุ
result_code	จำนวนเต็ม	รหัสผลลัพธ์
result_msg	สตริง	ข้อความผลลัพธ์
data	JSON	ข้อมูลผลลัพธ์
data.enc_idp	สตริง	คีย์สำหรับเข้ารหัสข้อมูลใน Request Body	โทเค็นใช้ครั้งเดียวสำหรับการเข้าสู่ระบบอัตโนมัติจากภายนอกบน PC
data.player_id	จำนวนเต็มขนาดใหญ่	PlayerID
data.list	อาเรย์	รายการ IdP ที่เชื่อมโยง	รายการที่มีข้อมูลของ IdP ที่ผู้ใช้เชื่อมโยง
data.list.seq	จำนวนเต็มขนาดใหญ่	รายการ IdP ที่เชื่อมโยง - Seq	คีย์ลำดับที่ใช้เฉพาะในกระบวนการตรวจสอบสิทธิ์
data.list.player_id	จำนวนเต็มขนาดใหญ่	รายการ IdP ที่เชื่อมโยง - PlayerID
data.list.idp_user_id	สตริง	รายการ IdP ที่เชื่อมโยง - รหัสประจำตัวที่ไม่ซ้ำของ IdP
data.list.idp_index	จำนวนเต็ม	รายการ IdP ที่เชื่อมโยง - ดัชนี IdP	1: HIVE 2: FACEBOOK 3: GOOGLE 9: APPLE 10: LINE 14: GOOGLE_PLAY_GAMES 18: STEAM 19: X
data.list.idp_id	สตริง	รายการ IdP ที่เชื่อมโยง - รหัส IdP	GUEST ถูกสร้างขึ้นโดยค่าเริ่มต้นแม้ว่าจะเล่นด้วย IdP อื่น
data.is_blocked	บูลีน	ว่าผู้ใช้ถูกบล็อกหรือไม่	true: ผู้ใช้ถูกบล็อก false: ผู้ใช้ปกติ
data.is_refund	บูลีน	ว่าผู้ใช้ต้องชำระเงินคืนสำหรับการคืนเงินหรือไม่	true: ผู้ใช้ต้องชำระเงินคืนสำหรับการคืนเงิน false: ผู้ใช้ไม่ต้องชำระเงินคืนสำหรับการคืนเงิน

รหัสผลลัพธ์

รหัสผลลัพธ์	คำอธิบาย
0	สำเร็จ
2002	ไม่มีข้อมูลผู้ใช้
4000	พารามิเตอร์คำขอไม่ถูกต้อง

ตัวอย่างเนื้อหาการตอบกลับ (ข้อมูลผู้ใช้มีอยู่)

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "data": {
    "enc_idp": "K+A4xduO7kf5OrJ/iDPqL0PtMxwu7wW8JSBO+JJwSDDmJLvIi/6LG7TyWXdEHr9RNHM+/QXwc0+Y9z2eSRg7oeBBHmpOajzF1iiaacbFom4CsNy2fItendset7T0i0WYdyLQih3z5mDjcct47+gg2ovbp6kWRY8D+aGq+ZgaKiyr0Hmb1xmbWY/7cl1FjXTm0Nl9CWhO418bJFdwOpi+bw==",
    "player_id": 20000016588,
    "list": [
      {
        "seq": 25771,
        "player_id": 20000016588,
        "idp_user_id": "68101398",
        "idp_index": 1,
        "idp_id": "HIVE"
      },
      {
        "seq": 25772,
        "player_id": 20000016588,
        "idp_user_id": "0",
        "idp_index": 0,
        "idp_id": "GUEST"
      }
    ],
    "is_blocked": false,
    "is_refund": false
  }
}

ตัวอย่างเนื้อหาการตอบกลับ (ไม่มีข้อมูลผู้ใช้)

{
  "result_code": 2002,
  "result_msg": "No User",
  "data": {
    "enc_idp": "K+A4xduO7kf5OrJ/iDPqLyCHfP+L3wz0WTNVw5KHLCqYjqQ+shQ2P3mkgwYCMvlnPatzlSE5ZFINr5gEIxK14sg0N8kOPSjSCeQ9UGGt11OMrYsGTuys0KmPJ2ZU/UWVVxpP1Lxx1eS8VbYwLmoTG+HTw2vkocghs/ZOZ9rqisdBRprhp6Q6+lIjpaUzDa2yy2guM1WheuVzKGL5331HHgo557RqoyUzTc6Lkf8ArWZ/XSwi3ZmStmhz/U4thcIwiowqgV+Ecdb2+WmMZ1MgGT4Xvbxa4lqzToBC3nxDvi1d8TjgMaszVYoNct94WPBGvV6emg3GqiJG+0ZTGg53+mZad9ttkUpTnQXetz5UDTxe5NnFAYfffzBq3jkqfAB042eH21rE3uTVJq3HuO8i9t1LJwKFfkC7sjjuaKNWsjs="
  }
}

ตัวอย่างเนื้อหาการตอบกลับ (ความล้มเหลว)

{
  "result_code": 4000,
  "result_msg": "Request has invalid format.",
  "data": "appid, idp_user_id, idp_index"
}