{
"opencollection": "1.0.0",
"info": {
"name": "Wincl Admin Coupon API",
"version": "1.0"
},
"items": [
{
"info": {
"name": "Coupon",
"type": "folder"
},
"items": [
{
"info": {
"name": "이벤트, 매직쿠폰 및 연결된 개인쿠폰들을 삭제합니다.",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.wincl.io:443/bapi/v2/coupons/events/:eventId",
"params": [
{
"name": "eventId",
"value": "",
"type": "path",
"description": "이벤트 ID"
}
],
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"docs": "`eventId`는 `/magic/register`에 사용한 값과 같아야 합니다.
이벤트, 매직쿠폰 및 발행된 모든 개인쿠폰을 삭제합니다."
},
{
"info": {
"name": "2. 이벤트용 사용자 쿠폰을 벌크로 발행합니다.",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.wincl.io:443/bapi/v2/coupons/magic/issue",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"docs": "`eventId, magicCouponCode, amount`는 `/magic/register`에 사용한 값과 같아야 합니다.
이벤트 참여 1개당 개인쿠폰 1개씩 서버 내부에서 연결됩니다.
발행할 개인쿠폰 갯수 (`couponCount`)도 윈클로부터 받아야 합니다."
},
{
"info": {
"name": "1. 이벤트용 매직 쿠폰을 발행합니다.",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.wincl.io:443/bapi/v2/coupons/magic/register",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"docs": "호출하면 `event*` 필드들로 이벤트를 생성한 후, 나머지 필드들로 매직쿠폰을 생성합니다.
`eventId`는 아무 값이나 쓰면 되고, `eventName, eventDescription`은 윈클로부터 받습니다.
매직쿠폰은 모든 이벤트 참여자가 공용으로 사용하는 단일쿠폰입니다.
`magicCouponCode, productId`는 윈클에서 정해서 알려주어야 합니다.
`senderUserId`는 상품을 벌크구매한 윈클 대표 가입자ID이고 `creditId`는 윈클의 구매ID로 둘 다 내부에서 알 수 있습니다.
`productId`는 상품ID 입니다. (예: 캄보이아 = 1676884519406W4iqG0qk2W)
지급 금액 (`amount`)은 윈클에서 결정하는 각 이벤트 참여자에게 지급할 배출권 양(톤)입니다."
},
{
"info": {
"name": "3. 쿠폰 응모 때 입력한 정보를 수집합니다. (접근토큰이 필요없음)",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.wincl.io:443/api/v2/coupons/magic/answer",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"docs": "이벤트 참여를 위한 참자가 정보 (나이, 성별)을 수집합니다. 가입 전 호출하므로 접근토큰이 필요없습니다."
},
{
"info": {
"name": "4. 쿠폰을 사용하여 탄소배출권을 얻습니다. (접근토큰이 필요함)",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.wincl.io:443/api/v2/coupons/magic/consume",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"docs": "가입 후 이벤트 때 받았던 매직쿠폰 코드를 입력하면, 사용자 지갑에 배출권을 넣어줍니다.
서버 내부에서는 개인쿠폰으로 변환하고, 배출권을 윈클 지갑에서 꺼내 개인 지갑으로 이동시킵니다."
}
]
}
],
"bundled": true
}