인벤토리 API 정의서

개요

• 쿠폰/빌링 시스템에서 유저에게 지급할 아이템을 인벤토리 시스템에 등록하여 게임서버에서 조회 및 아이템을 지급할 수 있습니다.

  • 기술 PM에게 사전에 요청한 상태에서 이용 가능하며, API 요청에 사용하는 인증 키를 전달드립니다.

  • 빌링 시스템에서 이용할 경우, 모든 결제 수단이 아닌 외부결제에 한해서 인벤토리 시스템이 연동됩니다.

    • 외부결제 : 게임 외부에서 구매를 시작하는 결제 수단. 예) PG, Unipin, CodaShop 등

• 게임 플레이에 직접적인 영향을 주는 기능이 아니므로 API 이용시 비동기 처리를 하여 API 요청 실패가 게임이나 UX에 영향을 미치지 않도록 처리해야 합니다.

  • 특히 조회 API는 게임에서 빈번이 요청하기 때문에 요청 실패시 유연한 대처가 필요합니다.

인벤토리 시스템 이용 전체 시퀀스

시퀀스별 호출 API

2-1 : 아이템 조회

3-1 : 아이템 예약하기

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

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

상품 지급 실패+제외 4-1 : 아이템 사용 취소 및 영구 제외