콘텐츠로 이동

Hive Blockchain API

Hive 블록체인 API는 Hive에서 제공하는 AppID, PlayerID 기반으로 동작하는 Web3 게임 API입니다. 게임 유저가 NFT를 발행 및 소각할 수 있는 기능과 유저별 트랜잭션 로그 조회와 같은 Web3 게임에 최적화된 기능을 제공합니다. Hive 블록체인 API는 XPLA 블록체인을 지원합니다. XPLA 블록체인을 여러분의 게임 앱과 연동해, 게임 아이템을 NFT로 전환(Mint)하거나 반대로 NFT를 게임 아이템으로 전환(Burn)할 수 있습니다.


  • Mint
    • 게임 아이템을 블록체인의 NFT로 변환하고 유저의 지갑으로 전송
  • Burn
    • 유저가 지갑에 보유한 NFT를 다시 게임 아이템으로 변환해 게임으로 전송

사전 준비: Web3 기본 설정

Hive 블록체인을 사용하기 전 프로젝트에 대한 기본 설정이 필요합니다.

  1. Hive 콘솔에 가입 후 앱센터 > 프로젝트 관리 > 새 게임 등록하기에서 게임을 등록합니다.
  2. 앱센터 > AppID 관리 > 새 AppID 등록하기에서 AppID를 생성합니다.
    • AppID 만들기: 웹 로그인 AppID
    • 사용 용도 선택: 블록체인
    • 사용할 AppID 선택: "자동 생성된 AppID" 또는 "자동 생성된 AppID + 추가정보" 선택
  3. Hive 콘솔 > 블록체인 > XPLA > 기본 설정에서 프로젝트 정보를 입력합니다.
  4. Hive 블록체인 API 호출
    • Hive 콘솔 > 블록체인 > XPLA > 기본 설정에서 프로젝트를 선택한 후, ID와 SecretKey를 확인합니다.
    • 인증 토큰 발급 API의 Request Body에 ID와 SecretKey를 입력하고 API를 호출해 인증 토큰을 획득합니다.
    • Hive 블록체인 API 호출 시 Header Parameter에 인증 토큰 발급 API 응답값(data.accessToken)을 사용합니다.