MENU
      동시 접속자 (CCU) 조회

        동시 접속자 (CCU) 조회


        기사 요약

        선택한 3 개의 날짜에 대해, 동시 접속자를 시간 별 조회할 수 있습니다.

        요청

        GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/user/statistics/ccu?oneDate={oneDate}&twoDate={twoDate}&threeDate={threeDate}
        HTTP
        항목타입필수 여부설명비고
        projectIdStringOGamePot SDK의 projectId
        oneDateStringX첫번째 조회하려는 날짜YYYY-MM-DD
        twoDateStringX두번째 조회하려는 날짜YYYY-MM-DD
        threeDateStringX세번째 조회하려는 날짜YYYY-MM-DD
        참고

        쿼리로 oneDate, twoDate, threeDate가 있으며, 없을 시 당일 포함 이전 2일까지 조회합니다.

        요청 헤더

        헤더명필수 여부설명
        x-api-keyOGamePot에서 발급하는 인증 키
        accept-languageX사용 언어

        응답

        필드명타입설명
        statusInt결과값 (1: 성공)
        totalCountIntccu 조회 결과 (건)수
        createdAtString집계 일시
        oneInt(첫번째 일자에 대한) 해당시간 동시접속자 수
        twoInt(두번째 일자에 대한) 해당시간 동시접속자 수
        threeInt(세번째 일자에 대한) 해당시간 동시접속자 수

        예시

        요청 예시

        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'
        HTTP

        응답 예시

        {
          "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
                }
              }
            ]
          }
        }
        HTTP

        오류 코드

        Gamepot Open API 요청시 발생하는 공통 에러코드입니다.

        파라미터설명
        status오류 코드(1: 성공, 실패시 Error code 참고)
        message오류 상세 설명
        오류 코드설명
        -1대시보드에 없는 키를 사용한 경우
        -2대시보드의 키와 헤더의 키가 다른경우
        -3대시보드에서 삭제한 키를 사용한 경우
        -4대시보드에서 미사용으로 처리된 키를 사용한 경우
        -5키가 만료된 경우
        -6프로젝트 아이디가 없는 경우
        {
          "status": -6,
          "message": "projectId was wrong."
        }
        Plain text

        동시 접속자 (CCU) 조회 API 요청시 발생하는 에러코드입니다.

        오류 코드설명
        -11threeDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능
        -12twoDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능
        -13oneDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능

        이 문서가 도움이 되었습니까?

        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.