게임 개발팀 제작 요청사항

게임과 플랫폼 연동을 위해 게임 개발팀에서 제공 해 주셔야 하는 기능 목록입니다.

API와 기능은 제작 가이드를 제공 해 드리지만, 게임이나 서비스의 특성에 따라 스펙의 변경/추가/제거가 가능 합니다. 단, 모든 스펙 변경은 담당 기술PM과 협의가 필요합니다.

관리 기능 연동

게임 서버를 관리하고 온라인 중 서비스를 관리하기 위한 기능을 제공 해 주시면 IM Assemble 관리 체계를 통해 서비스를 자동으로 관리 할 수 있습니다.

서버 상태 조회

현재 서버의 상태와 전체 서버의 목록 등을 조회하는 기능으로, IM Assemble과 관리 체계를 연동 할 수 있습니다. API 형태나 DB질의 등 방법을 통해 실시간 서버의 상태를 조회 할 수 있는 방법으로 제공 해 주실 수 있습니다.

본 기능을 통해 운영 중 서버 이상 감지 및 서버 아이템 지급과 같은 API 호출기능을 일시 중단 여부 판단 등을 수행 합니다.

유저의 접속 상태 조회 (선택)

특정 유저가 서버에 접속 중인지 상태를 조회합니다. 접속 중인 유저의 추가 정보가 있다면 함께 전달 해 주시면 좋습니다.

해당 기능의 부하 여부에 따라 관리 툴에서만 사용 가능한지, 유저 서비스 사용 가능 여부를 결정 해 주실 수 있습니다.

서버 접속한 유저 킥 요청

서버에 접속 한 유저를 안정적으로 종료 하기 위한 기능은 제재, 점검, 등 운영 대응에 활용 됩니다.

API를 제공 해 주셔야 하며, API 호출시 즉시 연결 종료 할 것을 권장 합니다. 단, 실시간 종료가 불가능 하거나 운영 정책상 대기가 필요한 경우(예를 들어 현재 세션 종료 후 연결을 종료 함)예외적으로 처리 되는 점에 대해 가이드를 제공 해 주셔야 합니다.

모든 유저 킥

서버 점검에 앞서 접속 해 있는 모든(다수) 유저의 접속을 종료 합니다.

점검 전략에 따라 특정 그룹의 유저를 종료하는 기능을 제공 해 주실 수 있습니다.

특정 유저 킥

단일 유저의 접속을 종료 합니다. 일반적으로 해당 유저의 접속 여부를 확인 하지 않고 종료 요청을 할 수 있습니다.

동접 정보 조회 (선택)

서버에 접속 한 전체 유저의 CCU를 파악하기 위해 동접 정보를 조회 할 수 있는 기능을 제공 해 주실 수 있습니다.

일반적인 CCU 이력은 플랫폼에서 보관/관리 할 수 있으니 요청 시점의 실시간 혹은 실시간에 가까운 동접 정보를 조회 할 수 있어야 합니다.

단, 연결 지향적이지 않은 게임 서버는 동접 정보를 제공 해 주시 않으셔도 무방합니다.

플랫폼 연동

유저 제재 정보 갱신 요청 API

유저가 제재 되었을 때 플랫폼에서 게임에 실시간으로 알려드리는 API 입니다.

제재는 크게 접속 제재와 컨텐츠 제재로 나뉘며, 접속 제재의 경우 API 호출시 연결 종료(유저 킥) 할 것을 권장 합니다. 단, 실시간 종료가 불가능 하거나 운영 정책상 대기가 필요한 경우(예를 들어 현재 세션 종료 후 연결을 종료 함)예외적으로 처리 되는 점에 대해 가이드를 제공 해 주셔야 합니다.

본 API는 플랫폼에서 유저가 제재 처벌 되거나 제재 정보가 갱신 되었을 때, 그리고 제재가 종료 되었을 때 실시간으로 호출 합니다.

게임이나 GMTool 등에서 제재 해제 요청API를 호출 하여 제재를 처벌 하는 경우에도 동일하게 발생 합니다.

제재에 대한 상세한 내용은 유저 제재 를 참고 하셔서 게임의 특성에 맞게 제재 정보가 갱신 되었을 때 실시간으로 플랫폼에서 게임서버(혹은 GMTool)에 알려드릴 수 있는 API를 제작 후 가이드와 함께 공유 부탁 드립니다.

유저 탈퇴

유저가 탈퇴 할 때 현재 접속 중인 유저의 연결 종료를 위한 API가 필요합니다. 탈퇴 된 유저는 기본적으로 플랫폼에서 로그인이 제한되므로 게임에 접속 할 수 없습니다.

유저 탈퇴 API

유저가 플랫폼에서 탈퇴 되었거나, 더이상 게임을 이용하지 않기 위해 이용동의를 철회 하였을 때 알려드리는 API 입니다.

게임 외부에서 탈퇴/이용동의철회가 발생할 수 있어, 이 때 게임은 해당 유저의 연결을 종료 해야 합니다.

탈퇴 한 유저는 탈퇴 취소 기능을 통해 일정 기간(4주) 이내 다시 복구 될 수 있습니다. 탈퇴 즉시 데이터를 삭제 하지 않도록 주의 부탁 드립니다.

탈퇴(비활성화)시에 게임 내 처리가 필요한 경우에는 유저 탈퇴 API호출 시점을 활용 할 수 있습니다.

그렇지 않은 경우 단순 연결 종료만 실행 하여도 무방 합니다.

유저 탈퇴 취소 API

유저가 플랫폼에서 탈퇴나 이용동의철회를 번복 한 경우 유저 탈퇴가 취소 됩니다. 이때 알려드리는 API 입니다.

탈퇴 취소 시에 별도로 처리 할 내용이 없는 경우 요청은 무시하셔도 무방합니다.

빌링 감사 로그 DB 스키마 제작 요청

유저의 유료 재화의 감사 자료의 증적을 기록하고 주기적으로 감사 수행을 하기 위한 DB 스키마를 요청 합니다.

상세한 내용은 재화(코인)에 대한 기술 가이드를 참고 부탁 드립니다.

빌링 감사 로그 DB는 전수 대사작업을 통한 감사와 함께 인게임 유료 재화와 관련된 법적 준수 사항의 실행 목적으로 사용하므로 누락이나 중복 등 오차가 발생하지 않아야 합니다.

빌링 상품 지급 API

빌링 감사 로그를 기록하고 빌링 ProductID 로 아이템을 지급하는 API로 웹상점과 3자결제 등 게임 외부에서 결제가 발생하는 경우 해당 API를 통해 상품 지급을 요청 드립니다.

빌링 상품 지급 API는 빌링 상품 지급 API 제작 가이드를 참고 하셔서 API 연동가이드와 함께 API Endpoint를 기술PM에 전달 부탁 드립니다.

지급 시점에 빌링 감사 로그를 반드시 기록해야 합니다.

빌링 시스템은 API 호출이 실패 한 경우 백오프 기능이 있습니다. 플랫폼과 게임서버간의 네트워크 문제로 지급 요청이 중복으로 요청 될 수 있으니 아이템 지급 시에 BOID를 기록하여 중복 지급이 되지 않도록 방어코드가 작성 되어야 합니다.

아이템 지급 API

빌링 감사 로그를 기록하지 않고 단순 아이템 번호로 우편을 지급하는 API입니다. 일반적으로 쿠폰이나 운영정책상 지급 등에 활용 됩니다.

아이템 지급 API (쿠폰 등)는 무료 아이템 지급 API 제작 가이드 (Deprecated)를 참고 하셔서 API 연동가이드와 함께 API Endpoint를 기술PM에 전달 부탁 드립니다.

아이템 회수 API (선택)

빌링 시스템과 연동하여 지급 된 아이템(BOID를 가지는 모든 상품) 중 사용하지 않은 아이템을 회수하는 API 입니다. 운영 정책에 따라 사용 되지 않을 수 있으니 협의가 필요합니다.

회수 시점에 빌링 감사 로그를 반드시 확인해야 합니다.