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