> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Inbox API 레퍼런스

선물 상자 기능




선물이 첨부된 메시지 기능을 제공하는 서비스입니다.

메시지는 읽음 상태를 가집니다.<br>
읽음 상태의 메시지를 목록에 남길지, 목록에서 삭제할지 설정할 수 있습니다.

메시지에는 보상을 첨부할 수 있습니다.<br>
읽음 플래그를 세우는 대신, 메시지에 첨부된 보상을 수령할 수 있습니다.

메시지에는 유효기간(`expiresAt`)을 설정할 수 있습니다.<br>
유효기간이 지난 메시지는 읽지 않은 상태, 개봉 후 읽음 상태와 관계없이 자동으로 삭제됩니다.

특정 플레이어가 아니라 모든 플레이어에게 동일한 메시지를 배포하고 싶을 때는 "글로벌 메시지"를 사용합니다.<br>
글로벌 메시지는 마스터 데이터로 정의하며, 각 플레이어가 `ReceiveGlobalMessage`를 호출했을 때 아직 수신하지 않은 메시지를 해당 플레이어의 수신함에 복사합니다.

마스터 데이터의 등록은 관리 콘솔에서 등록하는 것 외에, GitHub에서 데이터를 반영하거나, GS2-Deploy를 사용해 CI에서 등록하는 워크플로우를 구성할 수 있습니다.

[마이크로서비스 소개 / GS2-Inbox](../../microservices/inbox)



- [GS2-Inbox Deploy/CDK 레퍼런스](/ko/api_reference/inbox/deploy/)
  
- [GS2-Inbox SDK API 레퍼런스](/ko/api_reference/inbox/sdk/)
  
- [GS2-Inbox SDK for Game Engine API 레퍼런스](/ko/api_reference/inbox/game_engine/)
  
- [GS2-Inbox 마스터 데이터 레퍼런스](/ko/api_reference/inbox/master_data/)
  
- [GS2-Inbox 스크립트 트리거 레퍼런스](/ko/api_reference/inbox/script/)
  
- [GS2-Inbox 트랜잭션 액션](/ko/api_reference/inbox/stamp_sheet/)