รายชื่อเพื่อนสำหรับ UA

หน้านี้อธิบายข้อมูล(VID, PlayerID) ของผู้ใช้ที่เชิญและผู้ใช้ที่ถูกเชิญซึ่งบรรลุ CPI ผ่านการได้มาซึ่งผู้ใช้ รวบรวมรายชื่อเพื่อนของแต่ละผู้ใช้โดยใช้ข้อมูลต่อไปนี้

• Request URL

  URL ทั่วไป	https://promotion.qpyou.cn/ua/user/invitee
  URL Sandbox	https://sandbox-promotion.qpyou.cn/ua/user/invitee
  HTTP Method	POST
  Content-Type	text/html
  Data Format	JSON

• หัวข้อ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  การอนุญาต	CertificationKey ที่ถูกต้องผ่าน Bearer Authorization	String	N

• หัวข้อ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  การอนุญาต	CertificationKey ที่ถูกต้องผ่านการอนุญาตแบบ Bearer	String	N

• คำขอ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  game_index	ดัชนีเกมที่ลงทะเบียนใน AppCenter.	จำนวนเต็ม	ใช่
  begin_id	ID แรกที่รายชื่อเพื่อนเริ่มต้นผ่าน CPI. (ค่าคือ 0 หากคำขอเป็นครั้งแรก)	จำนวนเต็ม	ใช่
  data_limit	จำนวนรายชื่อเพื่อนที่นำเข้าพร้อมกัน หากไม่มีการป้อนค่า ค่าเริ่มต้นคือ 1000.	จำนวนเต็ม	ไม่
  sender_vid	VID, PlayerID ของผู้ใช้ที่เชิญ.	สตริง	ไม่

• การตอบสนอง

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  result_code	รหัสการตอบสนอง 0: การตรวจสอบสำเร็จ อื่น ๆ: การตรวจสอบล้มเหลว	จำนวนเต็ม	ใช่
  result_message	ข้อความการตอบสนอง	สตริง	ใช่
  request	ข้อมูลที่ได้รับเมื่อเรียกใช้ API ที่ร้องขอ (ส่งข้อมูลการร้องขอ)	อาเรย์	ใช่
  ㄴ game_index	ดัชนีเกมที่ลงทะเบียนใน AppCenter.	จำนวนเต็ม	ใช่
  ㄴ begin_id	ID แรกที่รายชื่อเพื่อนเริ่มต้นผ่าน CPI (ค่าคือ 0 หากการร้องขอเป็นครั้งแรก)	จำนวนเต็ม	ใช่
  ㄴ data_limit	จำนวนเพื่อนที่นำเข้ามาในครั้งเดียว เมื่อไม่มีการป้อน ค่าดีฟอลต์คือ 1000.	จำนวนเต็ม	ไม่
  ㄴ sender_vid	VID, PlayerID ของผู้ใช้ที่เชิญ.	สตริง	ไม่
  result	รายชื่อเพื่อน Null ใช้ได้เมื่อไม่มีสิ่งใด	อาเรย์	ไม่
  ㄴ companion_id	ID ที่จัดการภายในใน HIVE.	สตริง	ใช่
  ㄴ sender_vid	VID, PlayerID ของผู้ใช้ที่เชิญ.	สตริง	ใช่
  ㄴ receiver_vid	VID, PlayerID ของผู้ใช้ที่ถูกเชิญ.	สตริง	ใช่
  ㄴ dateadd	ในขณะที่ผู้ใช้สองคนกลายเป็นเพื่อน.	สตริง (DateTime)	ใช่
  ㄴ id	ID ที่ไม่ซ้ำกันของข้อมูลปัจจุบัน (ใช้ได้เมื่อร้องขอข้อมูลถัดไป)	สตริง	ใช่
  result_count	จำนวนผลลัพธ์.	จำนวนเต็ม	ใช่
  last_id	ID ที่ไม่ซ้ำกันสุดท้ายในรายชื่อเพื่อนที่ส่งมา (ใช้ได้เมื่อร้องขอข้อมูลถัดไป)	จำนวนเต็ม	ใช่

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

  รหัส	ข้อความ	คำอธิบาย
  0	สำเร็จ	สำเร็จในการส่งข้อมูล
  201	พารามิเตอร์ไม่ถูกต้อง	เมื่อพารามิเตอร์ที่ส่งไม่ถูกต้องหรือไม่มีอยู่ (ค่าที่จำเป็นว่างเปล่า). เมื่อรูปแบบการส่งไม่ใช่ POST.

• ตัวอย่างการโทร

  curl -L -v
  -d '{"game_index": 539, "begin_id": 0, "data_limit": 3, "sender_vid": 21001}'
  -H "Content-Type: application/json"
  https://sandbox-promotion.qpyou.cn/ua/user/invitee
  

• Request ตัวอย่าง

  POST /ua/user/invitee HTTP/1.1
  > User-Agent: curl/7.29.0
  > Host: sandbox-promotion.qpyou.cn
  > Accept: /
  > Content-Type: application/json
  > Content-Length: 72
  

• Response ตัวอย่าง

  < HTTP/1.1 200 OK
  < Server: nginx
  < Date: Tue, 15 Mar 2022 03:26:19 GMT
  < Content-Type: application/json
  {"result_code":0,"result_message":"success","request":{"game_index":539,"begin_id":0,"data_limit":3,"sender_vid":21001},"result":[],"result_count":0,"last_id":0}