> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/undefined/undefined-2.md).

# 이벤트 참여내역

이벤트 참여내역 조회 기능은 로그인한 회원이 '마이페이지 - 참여내역'에서 참여한 이벤트 응모내역을 확인할 수 있습니다. 참여내역은 '이벤트 참여'와 '구매 사은 응모'로 나뉘어지며, '구매 사은 응모'에서는 해당 이벤트 응모 내역만 확인할 수 있습니다.

***

## 주요 기능

* **이벤트 참여내역 조회**
  * 로그인한 회원이 참여한 이벤트 목록을 조회합니다.
  * 구매 사은 이벤트 제외한 이벤트 참여내역을 확인합니다.
  * 기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 이벤트 참여내역을 조회합니다.
  * 필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 이벤트 참여내역을 조회합니다.
* **구매 사은 이벤트 참여내역 조회**
  * 로그인한 회원이 참여한 구매 사은 이벤트 목록을 조회합니다.
  * 기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 구매 사은 이벤트 참여내역을 조회합니다.
  * 필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 구매 사은 이벤트 참여내역을 조회합니다.
* **이벤트 배송지 정보 변경**
  * 리워드가 경품/사은품인 경우, Default 배송지는 회원의 기본 배송지로 들어갑니다.
  * 이벤트 배송지 저장 API를 통해 변경이 가능하며, 수정 시 리워드 배송지(경품/사은품)가 변경된 주소로 저장됩니다.

## 프로세스 정의

<figure><img src="/files/mKn64pR0azanefveRbWs" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 마이페이지 이동

회원이 마이페이지에 접근할 때 로그인 상태일 시 회원의 정보를 노출시켜주고 비로그인 상태일 시 로그인 페이지로 이동됩니다.
{% endstep %}

{% step %}

### 이벤트 참여내역

참여내역 접근 시, 기본 Default값으로 1주 내에 있는 이벤트 참여내역을 조회합니다.\
기간 검색 코드 값과 필터링 값(진행중, 종료, 당첨)을 통해 조회 조건을 바꿔 조회가 가능합니다.
{% endstep %}

{% step %}

### 이벤트 배송지 저장

지급이 되지 않았으며, 리워드가 사은품/경품인 경우 수령지 변경 선택을 하여 이벤트 배송지 변경하여 저장할 수 있습니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="147.888916015625">API</th><th width="231.111083984375">설명</th><th width="93.5555419921875">Server</th><th width="91.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>이벤트 참여내역 조회</td><td>로그인한 회원의 참여내역을 조회합니다.</td><td>Event</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=getMyEventEntryList">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 구매 <br>사은 응모 내역 조회</td><td>로그인한 회원의 구매 사은 응모 내역을 조회합니다.</td><td>Event</td><td>GET</td><td><p><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=getPurFreeEventList">🔗API 확인하기 ></a></p><p>주문정보 조회: /api/order/v1/event/evtOrdList</p><p>상품요약정보 조회: /api/goods/v1/detail/summary</p></td></tr><tr><td>이벤트 배송지 <br>저장</td><td>응모한 회원의 이벤트 배송지를 변경 후 저장합니다.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=evtDlvChange">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="169.5555419921875">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>전시기간​</td><td>이벤트가 이벤트 목록에서 전시되는 기간을 말합니다.​ 전시기간이 끝난 이벤트는 상세 진입이 안됩니다.​</td><td></td></tr><tr><td>응모기간(행사기간)​</td><td>이벤트 상세 화면에서 응모 버튼 눌렀을때, 응모 할 수 있는 기간을 말합니다.​</td><td></td></tr><tr><td>구매기간​</td><td>이벤트에 적용되는 상품을 구매할 수 있는 기간을 말합니다.​</td><td></td></tr><tr><td>추첨이벤트​</td><td>기업에서 소비자들에게 사은품, 마일리지, 쿠폰 등 다양한 상품을 제공하기 위해 추첨을 통해 선발하는 이벤트를 말합니다​.</td><td></td></tr><tr><td>비추첨이벤트​</td><td>참여자들이 특정 조건을 만족하거나 특별한 활동을 수행함으로써 혜택(쿠폰,마일리지)을 지급하는 이벤트를 말합니다.​ (추첨이 아닌 즉시지급-출석, 구매사은 등)​</td><td></td></tr><tr><td>이벤트리워드​</td><td>이벤트에 참여한 사람들에게 주어지는 보상이나 혜택을 나타냅니다. ​ 이벤트 당첨 시, 제공하는 혜택 정보에는 사은품, 경품, 마일리지, 쿠폰 등이 있습니다.​</td><td></td></tr></tbody></table>

## 기타 참고사항

* **이벤트 참여 내역 / 구매 사은 응모 내역 조회**

  이벤트 참여내역 및 구매 사은 응모 내역 조회에는 기간 검색 구분 코드( periodGb )와 필터링 구분 값( filteringGb )을 조회 조건으로 받아 조회합니다.

  * 기간 검색 구분 코드 ( periodGb )
    * 0 : 1주일
    * 1 : 1개월
    * 2 : 3개월
    * 3 : 기간검색
  * 필터링 구분 코드 ( filteringGb )

    * Default : 전체
    * 1 : 당첨된 이벤트
    * 2 : 진행중 이벤트
    * 3 : 종료된 이벤트

* **이벤트 배송지 저장**

  이벤트 배송지 저장은 리워드가 사은품/경품 일때만 가능합니다.

  이벤트 배송지 저장은 아래의 경우 '수령지 변경' 버튼이 노출되지 않아 저장이 불가합니다.

  * 지급여부 Y
  * 지급일시 존재
  * 기타사은품배송지번호 존재
  * 이벤트 진행상태(EV005) : 경품발송완료(07)
  * 기타사은품상태코드(LO013) : 배송완료(40)

  이벤트 배송지는 CC\_EVT\_TRGMN\_INFO 의 응모자 테이블의 주소 정보가 UPDATE 됩니다.