동시 접속자 (CCU) 조회

선택한 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 형태만 가능