同時接続者(CCU)照会

Prev Next

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

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

要請

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

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

要請Header

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

応答

フィールド名 タイプ 説明
status Int 結果値 (1: 成功)
totalCount Int ccu 照会結果(件)数
createdAt String 集計日時
one Int (最初の日付に対する)該当時間同時接続者数
two Int (2番目の日付に対する)該当時間同時接続者数
three Int (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を使用した場合
-5 keyが切れた場合
-6 プロジェクトIDがない場合
{
  "status": -6,
  "message": "projectId was wrong."
}

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

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