UA 的朋友列表

此頁面描述了通過用戶獲取達成CPI的邀請和被邀請用戶的信息（VID，PlayerID）。使用以下數據組成每個用戶的好友列表。

• 請求 URL

  常用 URL	https://promotion.qpyou.cn/ua/user/invitee
  沙盒 URL	https://sandbox-promotion.qpyou.cn/ua/user/invitee
  HTTP 方法	POST
  內容類型	text/html
  數據格式	JSON

• 標題

  字段名稱	描述	類型	必需
  授權	通過 Bearer 授權的 CertificationKey 有效	字符串	N

• 標題

  欄位名稱	描述	類型	是否必填
  授權	透過 Bearer 授權的 CertificationKey 有效	字串	N

• 請求

  欄位名稱	描述	類型	必填
  game_index	在 AppCenter 中註冊的遊戲索引。	整數	是
  begin_id	朋友列表通過 CPI 開始的第一個 ID。（如果請求是第一次，則值為 0）	整數	是
  data_limit	一次導入的朋友列表數量。如果未輸入任何內容，則默認值為 1000。	整數	否
  sender_vid	邀請用戶的 VID、PlayerID。	字符串	否

• 回應

  欄位名稱	描述	類型	必填
  result_code	回應代碼 0: 驗證成功 其他: 驗證失敗	整數	Y
  result_message	回應訊息	字串	Y
  request	執行 API 時收到的資料請求。 (發送請求資料)	陣列	Y
  ㄴ game_index	在 AppCenter 註冊的遊戲索引。	整數	Y
  ㄴ begin_id	朋友列表通過 CPI 開始的第一個 ID。 (如果請求是第一次，值為 0)	整數	Y
  ㄴ data_limit	一次導入的朋友列表數量。當沒有輸入時，預設值為 1000。	整數	N
  ㄴ sender_vid	邀請用戶的 VID，PlayerID。	字串	N
  result	朋友列表。當不存在時可為 Null。	陣列	N
  ㄴ companion_id	在 HIVE 中內部管理的 ID。	字串	Y
  ㄴ sender_vid	邀請用戶的 VID，PlayerID。	字串	Y
  ㄴ receiver_vid	被邀請用戶的 VID，PlayerID。	字串	Y
  ㄴ dateadd	當兩個用戶成為朋友的時間。	字串 (日期時間)	Y
  ㄴ id	當前資料的唯一 ID。 (請求下一個資料時可用)	字串	Y
  result_count	結果的數量。	整數	Y
  last_id	傳輸的朋友列表中的最後唯一 ID。 (請求下一個資料時可用)	整數	Y

• 結果 代碼

  代碼	訊息	描述
  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}