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

# GS2-SerialKey API 레퍼런스

시리얼 코드 기능




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

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

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

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

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

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



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