MENU
      일반 쿠폰 사용 조회
        • PDF

        일반 쿠폰 사용 조회

        • PDF

        기사 요약

        일반 쿠폰 사용 내역을 조회합니다.
        키워드 쿠폰 사용 내역은 조회되지 않습니다.

        요청

        GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/coupon/{couponNumber}
        HTTP
        항목타입필수 여부설명비고
        projectIdStringOGamePot SDK의 projectId
        couponNumberStringO대시보드에서 발급한 쿠폰 번호

        요청 헤더

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

        응답

        필드명타입설명
        statusInt결과값 (1: 성공)
        idString쿠폰 사용 내역 아이디
        statusBoolean쿠폰 사용 여부(true: 사용, false: 미사용)
        enableInt사용가능 여부
        numberString쿠폰 번호
        userdataString쿠폰 사용 유저 정보
        usedAtString쿠폰 사용일
        requestString쿠폰 사용 요청
        responseString쿠폰 사용 응답
        (coupon_id의) idString쿠폰 아이디
        (coupon_id의) enableint사용가능 여부
        typeString쿠폰 타입
        keywordString키워드 쿠폰 키워드
        descString쿠폰명
        usedint쿠폰 상태
        countint쿠폰 수량
        lengthint쿠폰 길이
        limitString아이템 수량
        prefixString쿠폰 접미사
        suffixString쿠폰 접두사
        store_idString스토어 아이디 (google,one,apple,galaxy)
        startedAtString쿠폰 사용 시작일
        endedAtString쿠폰 사용 종료일
        item_idString아이템 아이디
        store_item_idString아이템 스토어 아이디
        countint아이템 수량

        예시

        요청 예시

        curl --request GET \
          --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/coupon/xxxxxx  \
          --header 'accept-language: ko' \
          --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
        HTTP

        응답 예시

        {
          "status": 1,
          "result": {
            "id": "xxxxxxxxxxxxxxxx",
            "status": false,
            "enable": 1,
            "number": "xxxxxxxxxxxxxxxx",
            "userdata": "",
            "usedAt": null,
            "createdAt": "Wed May 13 2020 12:12:04 GMT+0900 (Korean Standard Time)",
            "request": null,
            "response": null,
            "coupon_id": {
              "id": "xxxxxxxxxxxxxxxx",
              "enable": 1,
              "type": "normal",
              "keyword": null,
              "desc": "시즌2 업데이트 사전예약 보상",
              "used": 1,
              "count": 2010,
              "length": 7,
              "limit": null,
              "prefix": "",
              "suffix": "",
              "store_id": "",
              "startedAt": "Sun May 10 2020 16:35:00 GMT+0900 (Korean Standard Time)",
              "endedAt": "Sat May 23 2020 16:35:00 GMT+0900 (Korean Standard Time)",
              "items": [
                {
                  "item_id": "xxxxxxxxxxxxxxxx",
                  "store_item_id": "xxxxxxxxxxxxxxxx",
                  "count": 10
                },
                {
                  "item_id": "xxxxxxxxxxxxxxxx",
                  "store_item_id": "xxxxxxxxxxxxxxxx",
                  "count": 1
                }
              ]
            }
          }
        }
        HTTP

        오류 코드

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

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

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

        What's Next
        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.