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

# GS2-Distributor API 레퍼런스

트랜잭션 처리 기능




프로퍼티의 증가 처리를 중계하여, 대상 소지 수량이 상한에 도달한 경우 GS2-Inbox로 전송하는 기능을 제공합니다.<br>
이 기능을 이용하면 소지 수량이 상한에 도달했을 때의 복잡한 분기 처리를 없앨 수 있어, 의도하지 않은 데이터 손실의 위험을 피할 수 있습니다.

그 밖에도, GS2 내에서 일관성 있는 처리를 실현하기 위한 구조인 트랜잭션의 실행 처리에도 사용됩니다.

검증 액션은 트랜잭션 실행을 시작하기 전에, 소비 액션이나 입수 액션을 실행할 수 있는 상태인지를 사전에 체크하는 액션입니다.<br>
예를 들어 "특정 아이템을 소지하고 있는지", "랭크가 일정 값 이상인지", "특정 퀘스트를 클리어했는지" 와 같은 조건을, 소비가 발생하기 전에 확인할 수 있습니다.

소비 액션은 플레이어에게 불이익이 되는 처리를 나타내는 액션입니다.<br>
아이템 소비, 통화 소비, 스태미나 소비, 횟수 제한 카운터 증가 등이 여기에 해당합니다.

입수 액션은 플레이어에게 이익이 되는 처리를 나타내는 액션입니다.<br>
아이템 입수, 통화 입수, 경험치 입수, 퀘스트 시작 처리 등이 여기에 해당합니다.

GS2 의 트랜잭션은 여러 개의 검증 액션·여러 개의 소비 액션·여러 개의 입수 액션을 조합한 구조로 발행됩니다.<br>
트랜잭션은 GS2-Showcase / GS2-Quest / GS2-Mission 등 각 마이크로서비스의 트랜잭션 발행 API 응답으로 받으며, 게임 클라이언트는 취득한 트랜잭션을 GS2-Distributor 를 통해 실행합니다.

또한 GS2 SDK 에는 트랜잭션 실행을 자동화하는 구조가 내장되어 있어, 대부분의 경우 게임 측에서 트랜잭션을 의식적으로 실행할 필요는 없습니다.<br>
발행 API 결과에 포함된 `TransactionDomain` 의 `WaitAsync` 를 호출하는 것만으로, 소비 액션·입수 액션이 올바른 순서로 실행되어 결과를 취득할 수 있습니다.

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



- [GS2-Distributor Deploy/CDK 레퍼런스](/ko/api_reference/distributor/deploy/)
  
- [GS2-Distributor SDK API 레퍼런스](/ko/api_reference/distributor/sdk/)
  
- [GS2-Distributor SDK for Game Engine API 레퍼런스](/ko/api_reference/distributor/game_engine/)
  
- [GS2-Distributor 마스터 데이터 레퍼런스](/ko/api_reference/distributor/master_data/)
  
- [GS2-Distributor 트랜잭션 액션](/ko/api_reference/distributor/stamp_sheet/)