[API] 리워드 사용내역

리워드 사용 내역 조회

Reward 사용내역 조회 API

요약

• URL: /api/reward-transactions/{msrl}
• HTTP 메서드: GET

요청

• 요청 예시:

  GET /api/reward-transactions/123

• 요청 매개변수:

  • {msrl} (경로 매개변수): 조회하려는 회원(Member)의 고유 식별 번호(msrl).

응답

• 성공 시 응답 코드: 200 OK
• 실패 시 응답 코드: 404 Not Found (만약 해당 회원이나 사용 내역이 없는 경우)

응답 본문 (성공 시):

{
  "success": true,
  "code": 0,
  "msg": "성공하였습니다.",
  "list": [
    {
      "points": -30000,
      "transactionDate": "2023-08-22T21:46:00.650672",
      "productName": "컵",
      "productCount": 2
    },
    {
      "points": -10000,
      "transactionDate": "2023-08-22T21:46:05.191259",
      "productName": "티셔츠",
      "productCount": 1
    },
    {
      "points": -8000,
      "transactionDate": "2023-08-22T21:46:09.545448",
      "productName": "샤프",
      "productCount": 1
    }
  ]
}

응답 본문 (실패 시):

{
  "code": 404,
  "message": "Not Found",
  "data": "Reward transactions not found for member with msrl: 123"
}

응답 필드

• success (boolean): 요청이 성공적으로 처리되었는지 나타내는 플래그. 성공한 경우 true, 그렇지 않으면 false.>

• code (number): 요청 처리 결과에 대한 상태 코드. 성공한 경우 0을 사용하고, 실패한 경우 다른 코드를 사용할 수 있습니다.

• msg (string): 요청 처리 결과에 대한 간단한 메시지. 예를 들어, "성공하였습니다." 또는 "오류 발생"과 같은 메시지입니다.

• list (array): 사용 내역의 목록. 각 항목은 다음 필드를 포함합니다:

• points (number): 리워드 포인트 변경량. 사용한 경우 음수 값, 획득한 경우 양수 값입니다.

• transactionDate (string): 거래 일자 및 시간.

• productName (string): 상품 이름.

• productCount (number): 상품 수량.