UAの友達リスト

このページでは、ユーザー獲得を通じてCPIを達成した招待者と招待されたユーザーの情報(VIDPlayerID)について説明します。次のデータを使用して、各ユーザーの友達リストを作成してください。

  • リクエスト URL
    共通URL https://promotion.qpyou.cn/ua/user/invitee
    サンドボックスURL https://sandbox-promotion.qpyou.cn/ua/user/invitee
    HTTPメソッド POST
    Content-Type 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 2人のユーザーが友達になる時点。 文字列 (DateTime) 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
    
  • リクエスト サンプル
    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}