🔬
MIRACLE PLAY - Esports Tournament Platform
HOMEGAMEMIRACLE GENESISCONTACT US
English
English
  • 🎉WELCOME TO MIRACLEPLAY
    • About MiraclePlay
    • How to Login Miracle Play
      • Sign Up with an Email Account
      • Sign Up with a MetaMask Wallet
    • KYC Verification
  • 🎮MIRACLE TOURNAMENT
    • Tournament Details
    • Tournament Prize
    • Miracle Game List
      • Download Game
      • Game Tutorial
        • Dota2
          • Setting Up Dota 2 in Advance
          • Scoring in Dota 2
        • Miracle Hoop
          • How to Join a Miracle Hoop Tournament
          • Tournament Match Format
        • Miracle Golf
          • How to Join a Miracle Golf Tournament
          • Tournament Match Format
        • Bubble Shooter
          • How to Participate in the Miracle Play Tournament
          • Tournament Match Format
        • Miracle Bingo
          • How to Join a Miracle Play Tournament
          • Tournament Match Format
        • Battle Tank
          • How to Join a Miracle Play Tournament
          • Tournament Match Format
        • Miracle Slide
          • How to Join a Miracle Play Tournament
          • Tournament Match Format
        • Bear Baker Tap Tap
          • How to Join a BearBaker Tap Tap Tournament
          • Tournament Match Format
        • BrickGalaxy
          • How to Join a Brick Galaxy Tournament
          • Tournament Match Format
  • 💎MIRACLE GENESIS
    • Miracle NFT Minting Guide
      • Set the Wallet
      • How to Buy MPT
      • Polygon: NFT Minting
      • Avalanche: NFT Minting
    • Miracle NFT Staking Guide
    • MPT Token Staking Guide
  • 🪙TOKENOMICS
    • Foundation Distribution & Circulation Schedule
    • Token Distribution Status
    • Contract Adresses
      • Foundation Addresses
      • Polygon(PoS)
      • Avalanche C-Chain
      • Base
      • opBNB
      • Arbitrum
      • Bridge
  • 🏁ROADMAP
    • Q1-Q4 2024
  • 📖PRIZE FUNDING
    • How to Participate in a Prize Funding Tournament
  • MIRACLE CLUB
    • Miracle Club Beta
    • How to create a club
    • How to join a club
    • Club Rewards
  • GUIDE
    • Style Guide
    • Developer's Guide
      • ENG_Integration API Development Guide for Game Developers to Connect with MiraclePlay
        • MiraclePlay Integration Overview
        • MiraclePlay Integration Structure
        • Types of MiraclePlay Tournament Rules (As of November 2023)
          • A. Tournament type
          • B. Scoring Method
        • Implementation Examples by Game Genre
          • A. Asynchronous Score-based Competition Game
          • B. Real-time Score-based Competition Game
          • C. Real-time Duel Game
          • D. Real-time Multiplayer Battle Game
          • E. Arcade-style Action and Shooting Game
        • API Integration Implementation
          • A. Newly developed game
          • B. Games offering OPEN API
        • Recommended Client Features
        • API Integration Database Construction Examples
      • KR_Integration API Development Guide for Game Developers to Connect with MiraclePlay
        • MiraclePlay 연동 개요
        • Miracle Play 연동 구조
        • Miracle Play 경기 룰
          • A. 경기 방식
          • B. 집계 방식
        • 게임 장르별 구현 예시
          • A. 비동기 스코어 경쟁 게임
          • B. 실시간 스코어 경쟁 게임
          • C. 실시간 대전 게임
          • D. 실시간 멀티 대전 게임
          • E. 아케이드형 액션 및 슈팅 게임
        • API 연동 구현
          • A. 신규 개발 게임
          • B. OPEN API 제공 게임
        • 클라이언트 권장 기능 사항
        • 보안 정책
        • API 연동 Datavase 구축 예시
  • OFFICIAL CHANNEL
    • Website
    • Discord
    • X (twitter)
    • Pitch Deck (en)
    • Pitch Deck (kr)
    • Whitepaper (en)
    • Whitepaper (kr)
  • PARTNERSHIP
    • MIRACLE ECOSYSTEM
      • WEB3.0 & Blockchain Ecosystem
      • GameFi
      • Security
Powered by GitBook
On this page
  1. GUIDE
  2. Developer's Guide
  3. KR_Integration API Development Guide for Game Developers to Connect with MiraclePlay
  4. API 연동 구현

A. 신규 개발 게임

1. 신규 개발 게임 연동 구현 (예시: 미라클 슬라이드)

1.1 [Join API] 경기참여시, 계정유무 체크를 위한 API (현재 최소조건)

구분
설명
용도
타입
구성

UUID

해당 유저의 유니크ID

MiraclePlay 매칭 체크

POST

필수

NickName

존재 유무를 true/false 호출

실제 게임내 존재하는지 체크

POST

필수

ClientVer

클라이언트 버전 정보

참가자의 게임 최소 버전 일치

POST

선택

AccessKey

데이터보안을 위한 AccessKey

API호출시 필수 입력 필드값 추가

(제작사마다 방식이 다를 수 있음)

POST

선택

API URL

1.2 [GamaData API] 경기 결과를 기록하기 위한 API (게임마다 상이함)

구분
설명
용도
타입
구성

UUID

해당 유저의 유니크ID

MiraclePlay 매칭 체크

POST

필수

NickName

-

(미라클플레이의 닉네임을 사용)

POST

선택

ClientVer

클라이언트 버전 정보

참가자의 플레이시 버전 체크

POST

선택

Starttime

게임을 시작한 시간 (GMT)

경기 결과 집계

POST

게임별

Endtime

게임이 종료된 시간 (GMT)

경기 결과 집계

POST

게임별

Score

기록된 결과 데이터

경기 결과 집계

POST

게임별

playTime

총 플레이 시간

경기 결과 집계

POST

게임별

AccessKey

데이터보안을 위한 AccessKey

API호출시 필수 입력 필드값 추가

(제작사마다 방식이 다를 수 있음)

POST

선택

PreviousAPI 연동 구현NextB. OPEN API 제공 게임

Last updated 1 year ago