일반 쿠폰 사용 조회

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

요청

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

요청 헤더

헤더명 필수 여부 설명
x-api-key O GamePot에서 발급하는 인증 키
accept-language X 사용 언어

응답

필드명 타입 설명
status Int 결과값 (1: 성공)
id String 쿠폰 사용 내역 아이디
status Boolean 쿠폰 사용 여부(true: 사용, false: 미사용)
enable Int 사용가능 여부
number String 쿠폰 번호
userdata String 쿠폰 사용 유저 정보
usedAt String 쿠폰 사용일
request String 쿠폰 사용 요청
response String 쿠폰 사용 응답
(coupon_id의) id String 쿠폰 아이디
(coupon_id의) enable int 사용가능 여부
type String 쿠폰 타입
keyword String 키워드 쿠폰 키워드
desc String 쿠폰명
used int 쿠폰 상태
count int 쿠폰 수량
length int 쿠폰 길이
limit String 아이템 수량
prefix String 쿠폰 접미사
suffix String 쿠폰 접두사
store_id String 스토어 아이디 (google,one,apple,galaxy)
startedAt String 쿠폰 사용 시작일
endedAt String 쿠폰 사용 종료일
item_id String 아이템 아이디
store_item_id String 아이템 스토어 아이디
count int 아이템 수량

예시

요청 예시


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'

응답 예시

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

오류 코드

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

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