인벤토리 API 정의서

개요

대량의 트래픽을 고속으로 처리하기 위해서 별도의 도메인 end-point를 사용합니다.
쿠폰/빌링 시스템에서 유저에게 지급할 아이템을 인벤토리 시스템에 등록하여 게임서버에서 조회 및 아이템을 지급할 수 있습니다.
- 기술 PM에게 사전에 요청한 상태에서 이용 가능하며, API 요청에 사용하는 인증 키를 전달드립니다.
- 빌링 시스템에서 이용할 경우, 모든 결제 수단이 아닌 외부결제에 한해서 인벤토리 시스템이 연동됩니다.
  - 외부 결제 : 게임 외부에서 구매를 시작하는 결제 수단. 예) PG, Unipin, CodaShop 등
  - 내부 결제: 구글, 애플과 같이 게임에서 주도적으로 트랜잭션 처리를 진행하는 결제는 일반적으로 인벤토리 시스템을 사용하지 않습니다.
    내부 결제에서 유료 상품 보관함과 같은 기능의 대체안으로 사용하고 싶은 경우에는, 협의 후 추가 개발이 필요합니다.
게임 플레이에 직접적인 영향을 주는 기능이 아니므로 API 이용시 비동기 처리를 하여 API 요청 실패가 게임이나 UX에 영향을 미치지 않도록 처리해야 합니다.
- 특히 조회 API는 게임에서 빈번이 요청하기 때문에 요청 실패시 유연한 대처가 필요합니다.

상품 지급 성공 4-1 : 아이템 사용 확인

상품 지급 실패 4-1 : 아이템 사용 취소

Last updated 1 month ago