同時接続者(CCU)照会
    • PDF

    同時接続者(CCU)照会

    • PDF

    Article Summary

    当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。

    選択した3 つの日付に対し、同時接続者を時間別に照会できます。

    要請

    GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/user/statistics/ccu?oneDate={oneDate}&twoDate={twoDate}&threeDate={threeDate}
    
    項目タイプ必須かどうか説明備考
    projectIdStringOGamePot SDK의 projectId
    oneDateStringX一番最初に照会しようとする日付YYYY-MM-DD
    twoDateStringX二番目に照会しようとする日付YYYY-MM-DD
    threeDateStringX三番目に照会しようとする日付YYYY-MM-DD
    参考

    Queryに oneDate, twoDate, threeDateがあり、ない場合は当日を含めて2日まで照会します。

    要請Header

    Header名必須かどうか説明
    x-api-keyOGamePotで発行する認証key
    accept-languageX使用言語

    応答

    フィールド名タイプ説明
    statusInt結果値 (1: 成功)
    totalCountIntccu 照会結果(件)数
    createdAtString集計日時
    oneInt(最初の日付に対する)該当時間同時接続者数
    twoInt(2番目の日付に対する)該当時間同時接続者数
    threeInt(3 番目の日付に対する) 該当時間同時接続者数

    例示

    要請例

    curl --request GET \
    --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/user/statistics/ccu?oneDate=2020-03-01&twoDate=2020-04-01&threeDate=2020-05-09
    --header 'accept-language: ko' \
    --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
    

    応答例

    {
      "status": 1,
      "result": {
        "totalCount": 1440,
        "edges": [
          {
            "node": {
              "createdAt": "00:00",
              "one": 0,
              "two": 0,
              "three": 0
            }
          },
    
            ...
    
          {
            "node": {
              "createdAt": "23:59",
              "one": 0,
              "two": 0,
              "three": null
            }
          }
        ]
      }
    }
    

    エラーコード

    Gamepot Open APIリクエスト時に発生する共通エラーコードです。

    parameter説明
    statusエラーコード(1: 成功、失敗時Error code参考)
    messageエラー詳細説明
    エラーコード説明
    -1ダッシュボードにないkeyを使用した場合
    -2ダッシュボードのkeyとheaderのkeyが異なる場合
    -3ダッシュボードで削除したkeyを使用した場合
    -4ダッシュボードで未使用に処理されたkeyを使用した場合
    -5keyが切れた場合
    -6プロジェクトIDがない場合
    {
      "status": -6,
      "message": "projectId was wrong."
    }
    

    同時接続者(CCU) の照会API 要請時に発生するエラーコードです。

    エラーコード説明
    -11threeDate値のフォーマットが正しくない場合、 YYYY-MM-DD 形式のみ可能
    -12twoDate 値のフォーマットが正しくない場合、YYYY-MM-DD 形式のみ可能
    -13oneDate 값値のフォーマットが正しくない場合、YYYY-MM-DD 形式のみ可能

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.