ค้นหารายการ IdP การตรวจสอบสิทธิ์ v4

เซิร์ฟเวอร์เกมสามารถค้นหารายการ IdP ที่เชื่อมต่อกับเกมโดยใช้ playerID และ AppID ที่ส่งกลับจากเกมไคลเอนต์หลังจากเข้าสู่ระบบสำเร็จ เกมจะนำ API นี้ไปใช้โดยตรงเพื่อค้นหารายการจากเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์.

Request รวมถึง AppId และ PlayerID เป็นพารามิเตอร์ที่จำเป็น และ Response ที่สำเร็จจะส่งออกข้อมูล IdP ผ่านกลุ่มตัวแปรภายใต้ Data ตามจำนวนของ IdP ที่เชื่อมต่อกับ PlayerID.

• คำขอ URL

  URL ทั่วไป	https://auth.qpyou.cn/game/player/get-idp
  URL สภาพแวดล้อมที่กระจาย	https://auth.globalwithhive.com/game/player/get-idp
  URL Sandbox	https://sandbox-auth.qpyou.cn/game/player/get-idp
  HTTP Method	Post
  Content-Type	application/json
  รูปแบบข้อมูล	JSON

• Request Header

  Field Name	คำอธิบาย	ประเภท	จำเป็น
  ISCRYPT	ข้อมูลถูกเข้ารหัสหรือไม่ (0= ไม่เข้ารหัส)	จำนวนเต็ม	Y (ส่ง 0 เสมอ)

• Request Body

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  appid	AppID ของเกมที่ผู้ใช้เข้าสู่ระบบ	String	Y
  player_id	PlayerID ที่ส่งกลับจากการตรวจสอบสิทธิ์ v4 หลังจากเข้าสู่ระบบ	BigInteger	Y
  hive_certification_key	คีย์การรับรอง (ออกโดย AppCenter) ดูเพิ่มเติม	String	N

• Request Sample<

      { 
          "appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
          "player_id": 90000000062,
          "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
      }
  

• Response Body

  ชื่อฟิลด์	คำอธิบาย	ประเภท	ค่า
  result_code	ผลลัพธ์การค้นหา	จำนวนเต็ม	0
  result_msg	ข้อความผลลัพธ์	สตริง	0
  data		JSON
  data.seq	คีย์หลัก (PK) สำหรับผู้เล่น	จำนวนเต็มขนาดใหญ่	14
  data.player_id	PlayerID	จำนวนเต็มขนาดใหญ่	12
  data.idp_user_id	รหัสผู้ใช้ที่ให้โดย IdP	สตริง
  data.idp_index	ดัชนี IdP ที่ไม่ซ้ำกัน	สตริง
  data.idp_id	ตัวระบุ IdP	สตริง	HIVE, FACEBOOK ...

• Request Sample<

  { 
  "appid":"com.withhive",
  "did":"255764404509548", 
  "player_id": 21
  
  }
  

• Response Sample<

  {
  "result_code": 0,
  "result_msg": "สำเร็จ",
  "data":[
      {
      "seq": 10000000067,
      "player_id": 90000000062,
      "idp_user_id": "0",
      "idp_index": 0,
      "idp_id": "GUEST"
      },
      {
      "seq": 10000000068,
      "player_id": 90000000062,
      "idp_user_id": "64646595",
      "idp_index": 1,
      "idp_id": "HIVE"
      }
  ]
  }
  

• รหัส ผลลัพธ์

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

• idp_index

  idp_index	idp_id	คำอธิบาย
  0	GUEST	ผู้เล่นที่ไม่ได้ตรวจสอบ IdP
  1	HIVE	HIVE
  2	FACEBOOK	Facebook
  3	GOOGLE	Google (Play Games Services)
  4	QQ	QQ
  5	WEIBO	Weibo
  6	VK	VK
  7	WECHAT	WeChat
  8	APPLE	Apple Game Center
  9	SIGNIN_APPLE	Apple Login
  10	LINE	Line
  12	WEVERSE	Weverse