결제 매출 통계 조회
    • PDF

    결제 매출 통계 조회

    • PDF

    Article Summary

    결제 매출 통계를 조회합니다.

    요청

    GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/purchase/statistics?startDate={startDate}&endDate={endDate}&currency={currency}
    
    항목타입필수 여부설명비고
    projectIdStringOGamePot SDK의 projectId
    startDateStringX결제 매출 통계 검색 시작일YYYY-MM-DD
    endDateStringX결제 매출 통계 검색 종료일YYYY-MM-DD
    currencyStringX결제 매출 통계 통화 검색 (all...)ISO 4217규정을 따름
    참고

    쿼리로 startDate, endDate를 넣지 않으면 최근 30일간의 데이터를 조회함

    요청 헤더

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

    응답

    필드명타입설명
    statusInt결과값 (1: 성공)
    totalCountInt검색 결과 값 수
    currencyListString통화 리스트
    ISO 4217규정을 따름
    dateString통계 날짜
    countString매출 통계 금액

    예시

    요청 예시

    
    curl --request GET \
      --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/purchase/statistics?startDate=2020-05-01&endDate=2020-06-01&currency=all \
      --header 'accept-language: ko' \
      --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
    

    응답 예시

    "status": 1,
      "result": {
        "totalCount": 13,
        "currencyList": [
          "KRW",
          "USD"
        ],
        "edges": [
          {
            "node": {
              "date": "2020-05-01",
              "count": 0
            }
          },
          {
            "node": {
              "date": "2020-05-02",
              "count": 0
            }
          },
    
    ...
    
          {
            "node": {
              "date": "2020-05-13",
              "count": 4008857.31
            }
          }
        ]
      }
    }
    

    오류 코드

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

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

    결제 매출 통계 조회 API 요청시 발생하는 에러코드입니다.

    오류 코드설명
    -11startDate 값의 포멧이 올바르지 않은 경우, YYYY-MM-DD 형태만 가능
    -12endDate 값의 포멧이 올바르지 않은 경우, 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.