Hive API 가이드에서는 Hive를 사용할 때 반드시 적용해야 하는 Hive Server API 인증 v4 토큰 검증 API와 IAP v4 영수증 검증 API에 대해서 설명하고, Hive 아이템을 구현하는 방법과 관련된 링크를 제공합니다.
필수 적용 서버 API
인증 v4 토큰 검증
● API 설명: 인증 v4 토큰 검증하기
토큰 검증 API는 클라이언트에서 로그인 성공 후 반환된 토큰의 유효성을 검증하여 결과로 응답합니다.
게임에서 중복 로그인을 허용하지 않는 경우에는, 로그인한 유저의 토큰을 저장하여 이전 로그인에 사용된 토큰을 무효화, 즉 로그아웃하거나 게임 종료 처리되는 기능을 구현해야 합니다.
토큰 검증 서버는 해외에 위치한 서버에서 통신이 원활하지 않을 경우에 대비하여 분산 환경을 제공하고 있습니다. 상용 URL로 토큰 검증 결과를 응답받지 못했다면 분산 환경 URL로 한 번 더 검증을 요청하도록 기능을 구현해야 합니다.
IAP v4 영수증 검증
● API 설명: IAP v4 영수증 검증
영수증 검증 API는 인앱 구매된 영수증에 대해 검증을 수행 후 영수증의 정상 여부를 검증 결과로 응답합니다. 아래의 도식도를 통해 Hive IAP v4의 구매 과정을 알아보세요.
게임 내에서 상품을 결제한 유저에게 아이템을 지급하기 전에 반드시 게임 서버에서 Hive 서버로 영수증 검증을 요청해야 합니다. 영수증 검증 결과 응답되는 정보 중 hiveiap_transaction_id와 hiveiap_market_pid를 기준으로 상품 지급 여부를 판단하게 됩니다.
| 필드명 | 설명 | 타입 | 필수여부 |
|---|---|---|---|
| hiveiap_transaction_id | 검증 성공한 영수증 별로 생성되는 트랜잭션 ID 이 값을 게임 서버에 저장해서 게임이 영수증 중복 체크를 수행함 응답코드가 0(검증 성공)일 때만 값을 전달함 |
String | N |
| hiveiap_market_id | 결제된 마켓의 구분 코드 1: 애플 앱스토어 2: 구글 플레이스토어 3: 러비 4: 원스토어 응답코드가 0(검증 성공)일 때만 값을 전달함 |
Integer | N |
hiveiap_transaction_id
검증 성공한 영수증의 고유한 키값으로, Hive가 발급합니다.
동일한 영수증을 재사용하지 않도록 상품 지급 시 게임서버에 저장하고, 해당 영수증의 사용 여부를 판단해야 합니다. Hive는 영수증의 유효성만을 판단해 결과값을 반환하며, 구매 시도 후 영수증 검증인지, 상품 지급 실패에 따른 리스토어 동작으로 인한 영수증 검증인지는 구분할 수 없습니다.hiveiap_market_pid
영수증 검증 시 영수증에 포함된 상품 정보입니다. 클라이언트를 통해 전달되는 상품 정보는 변조의 위험이 있으므로 반드시 이 정보를 통해 상품을 판단하고 지급해야 합니다.
Hive 아이템
Hive 아이템은 게임 내의 재화나 아이템의 지급·회수 기능을 통합하여 관리할 수 있는 시스템입니다. Hive 아이템 연동은 쿠폰 시스템, 이벤트, 오퍼월, CPI 등과 연동하여 아이템을 지급 또는 회수하는 기능을 제공하며, 이 기능을 연동하려면 Hive 아이템을 반드시 적용해야 합니다. 관리자용 백오피스에서는 수동으로 지급·회수하거나 이력을 검색할 수도 있습니다.
Hive 아이템은 Hive 아이템 서버가 게임 서버에 아이템 지급 API나 아이템 회수 API를 호출하면 게임 서버가 응답하는 구조로 이루어져 있습니다. Hive 아이템의 지급·회수 요청 API에 대해 자세한 사항은 Hive Developers의 API > Hive Server API > 빌링 > Hive 아이템 연동 가이드를 참고하세요.
Hive 아이템과 연동하기 전에 먼저 Hive 콘솔의 빌링 > Hive 아이템 > 아이템 관리에서 게임 서버 URL과 아이템을 등록해야 합니다. Hive 아이템 관리에 대한 자세한 내용은 Hive Developers의 운영 > 빌링 > 아이템 관리 가이드를 참고하세요.