쿠폰 관리

뒤끝 콘솔에 등록한 쿠폰의 리스트를 받아오고, 사용하는 기능을 제공합니다.

쿠폰 리스트 받아오기

뒤끝 콘솔에 등록한 쿠폰의 리스트를 가져옵니다.

동기

CouponList ( ) -> BackendReturnObject

// example
Backend.Coupon.CouponList ();

비동기

CouponList ( Function callback ) -> void

// example
BackendAsyncClass.BackendAsync(Backend.Coupon.CouponList, ( callback ) =>
{
    // 이후 처리
});

결과값 예시

{
  rows: [
    {
      // 쿠폰 uuid
      uuid: { S: "c2054080-d75b-11e8-8857-994ebc4f2e58" },
      // 쿠폰 명
      title: { S: "회원가입 감사쿠폰" },
      // 쿠폰 타입 (serial/single):시리얼/단일
      type: { S: "serial" },
      // version 정보 (y: version1 , n: version2)
      old: { S: "y" },
    },
    {
      uuid: [Object],
      title: [Object],
      type: [Object],
      old: [Object],
    },
  ];
}

쿠폰 사용하기

자동생성된 쿠폰의 old 버전 쿠폰코드는 16자, new 버전 쿠폰코드는 18자 입니다.

동기

UseCoupon ( String couponCode ) -> BackendReturnObject

// example
Backend.Coupon.UseCoupon ( "18c7c2e1d16e779b" );

비동기

UseCoupon ( String couponCode , Function callback ) -> void

// example
BackendAsyncClass.BackendAsync(Backend.Coupon.UseCoupon, "18c7c2e1d16e779b", ( callback ) =>
{
    // 이후 처리
});

Parameter

ValueTypeDescription
couponCodeString뒤끝 콘솔에서 발급된 쿠폰 코드

Success cases

  • 지급아이템을 사용하지 않는 경우
    statusCode : 200
    message : Success
    returnValue : {"uuid":613}

  • 지급아이템을 사용한 경우
    statusCode : 200
    message : Success
    returnValue : 아래참조

결과값 예시

{
    uuid: "628",// 쿠폰 uuid
    items:{ // 차트 항목에 올린 아이템 정보
        chartFileName: "chartExample.xlsx",
        itemID: "i101",
        itemName: "아이템1",
        hpPower: "1",
        num: "1"
    },
    itemsCount: "1" // 지급되는 아이템 갯수
}

Error cases

  • Old Version 사용 시

    • 기간 만료된 쿠폰의 경우
      statusCode : 410
      errorCode : GoneResourceException
      message : Gone expired coupon, 사라진 expired coupon 입니다

    • 단일쿠폰의 회수율이 100%인 경우
      statusCode : 404
      errorCode : NotFoundException
      message : coupon not found, coupon을(를) 찾을 수 없습니다

    • 한 명의 게이머가 단일쿠폰을 두 번 이상 사용 시도한 경우
      statusCode : 409
      errorCode : ConflictErrorParameterException
      message : ConflictError use coupon, 충돌된 use coupon 입니다

    • 이미 사용한 시리얼쿠폰을 다시 사용한 경우
      statusCode : 404
      errorCode : NotFoundException
      message : coupon not found, coupon을(를) 찾을 수 없습니다

  • New Version 사용 시

    • 시리얼 쿠폰 중복사용
      statusCode : 404
      errorCode : NotFoundException
      message : 이미 사용되었거나, 틀린 번호입니다. not found, 이미 사용되었거나, 틀린 번호입니다.을(를) 찾을 수 없습니다

    • 단일쿠폰의 회수율이 100%인 경우, 기간 만료된 쿠폰의 경우
      statusCode : 404
      errorCode : NotFoundException
      message : 전부 사용 된 쿠폰입니다. not found, 전부 사용 된 쿠폰입니다.을(를) 찾을 수 없습니다

    • 한 명의 게이머가 단일쿠폰을 두 번 이상 사용 시도한 경우
      statusCode : 404
      errorCode : NotFoundException
      message : 이미 사용하신 쿠폰입니다. not found, 이미 사용하신 쿠폰입니다.을(를) 찾을 수 없습니다