선택한 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 |
참고
쿼리로 oneDate, twoDate, threeDate가 있으며, 없을 시 당일 포함 이전 2일까지 조회합니다.
요청 헤더
헤더명 |
필수 여부 |
설명 |
x-api-key |
O |
GamePot에서 발급하는 인증 키 |
accept-language |
X |
사용 언어 |
응답
필드명 |
타입 |
설명 |
status |
Int |
결과값 (1: 성공) |
totalCount |
Int |
ccu 조회 결과 (건)수 |
createdAt |
String |
집계 일시 |
one |
Int |
(첫번째 일자에 대한) 해당시간 동시접속자 수 |
two |
Int |
(두번째 일자에 대한) 해당시간 동시접속자 수 |
three |
Int |
(세번째 일자에 대한) 해당시간 동시접속자 수 |
예시
요청 예시
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 요청시 발생하는 공통 에러코드입니다.
파라미터 |
설명 |
status |
오류 코드(1: 성공, 실패시 Error code 참고) |
message |
오류 상세 설명 |
오류 코드 |
설명 |
-1 |
대시보드에 없는 키를 사용한 경우 |
-2 |
대시보드의 키와 헤더의 키가 다른경우 |
-3 |
대시보드에서 삭제한 키를 사용한 경우 |
-4 |
대시보드에서 미사용으로 처리된 키를 사용한 경우 |
-5 |
키가 만료된 경우 |
-6 |
프로젝트 아이디가 없는 경우 |
{
"status": -6,
"message": "projectId was wrong."
}
동시 접속자 (CCU) 조회 API 요청시 발생하는 에러코드입니다.
오류 코드 |
설명 |
-11 |
threeDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능 |
-12 |
twoDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능 |
-13 |
oneDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능 |