当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。
選択した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 形式のみ可能 |