일반 쿠폰 사용 조회

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

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

요청

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."
}

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

What's Next

쿠폰 사용

요청
응답
예시
오류 코드

태그

GAMEPOT