일반 쿠폰 사용 내역을 조회합니다.
키워드 쿠폰 사용 내역은 조회되지 않습니다.
요청
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."
}