GS2-SerialKey API 레퍼런스

시리얼 코드 또는 캠페인 코드를 다루기 위한 서비스입니다.
시리얼 코드는 한 번 사용하면 다시 사용할 수 없는 반면, 캠페인 코드는 모든 플레이어가 동일한 코드를 사용하며 GS2-Limit의 횟수 제한 등을 이용하여 여러 번 사용할 수 없도록 제어하는 것을 전제로 사용합니다.
시리얼 코드를 사용함으로써 대가를 얻을 수 있도록 GS2-Exchange의 교환 비율을 준비하는 등의 방식으로 활용해 주세요.

캠페인 코드는 “할로윈2025”, “SUMMER"와 같이 사람이 기억하기 쉬운 문자열을 운영 측에서 임의로 설정할 수 있는 코드입니다.
하나의 코드를 다수의 플레이어가 공유하여 교환에 사용하는 것을 상정하고 있습니다.

캠페인은 GS2-Schedule 의 이벤트와 연결하여 유효 기간을 설정할 수 있습니다.
유효 기간의 검증은 트랜잭션 액션을 조합하여 실현할 수 있습니다.

대상 캠페인과 발행 수량을 지정하여 시리얼 키 발행 처리를 실행하면 시리얼 키가 발행됩니다.
발행 처리는 비동기 작업으로 실행되며, IssueJob 을 통해 진행 상황을 확인할 수 있습니다.
발행된 시리얼 키 목록은 CSV 형식으로 다운로드할 수 있습니다.

실제로 플레이어가 이용할 수 있는 상태가 ACTIVE 이며, 사용하면 USED 가 됩니다.
운영 측에서 시리얼 키를 무효화하면 INACTIVE 가 됩니다.