Integration Guide v1.0

INTEGRATION PARAMETERS

Complete integration documentation for Rapidverse API. Launch games in minutes.

Integration Overview

Rapidverse provides a unified API for all game providers. Integrate once and get access to 5000+ games from JILI, SPRIBE, Evolution, PRAGMATIC, PG SOFT, and more.

DEMO For Testing & Integration
https://rapidverse.site/api/demo

No authentication required. Returns mock data for testing.

Example Response:
{
    "status": "demo",
    "gameUrl": "https://demo.rapidverse.io/launch/...",
    "sessionId": "demo_sess_12345",
    "message": "This is a demo response. For production, use /api/verse with valid credentials."
}
PRODUCTION Live Environment
https://rapidverse.site/api/verse

Requires valid API credentials. Use your registered API Token & Secret Key.

Live Response Example:
{
    "code": 1,
    "msg": "Authentication required. Please provide valid credentials."
}

This confirms the endpoint is active. Include X-API-Token and X-Secret-Key headers for full access.

Getting Started: Use the Demo endpoint to test your integration flow without credentials. When ready, switch to the Production endpoint with your registered API keys. Register now to get your credentials.

API Endpoints

POST https://rapidverse.site/api/demo (Demo - No Auth)

Test endpoint for integration testing. Returns mock game launch URLs.

POST https://rapidverse.site/api/verse (Production - Auth Required)

Main game launch endpoint. Initiates a game session for the player.

Integration Parameters

Send a POST request to the API endpoint with the following JSON payload parameters:

Parameter Type Required Description
userId String Yes Unique player identifier
gameCode String Yes Game identifier code
userBalance Float Yes Current player balance
vendorCode String Yes Provider code (JILI, SPRIBE, EVOLUTION, PRAGMATIC, PGSOFT)
language String No Language (0=EN,1=CN,2=JP,3=KR)
phonetype String No Device (1=Mobile,2=Desktop)
returnUrl String Yes Callback URL after game session

Game Launch Request

Example JSON payload for game launch:

{
    "userId": "YOUR_USER_ID",
    "gameCode": "YOUR_GAME_CODE",
    "userBalance": 1000.00,
    "vendorCode": "JILI",
    "language": "0",
    "phonetype": "1",
    "returnUrl": "https://yourdomain.com/callback"
}

Response Format

Successful response will contain the game launch URL:

{
    "status": "success",
    "gameUrl": "https://game.rapidverse.io/launch/...",
    "sessionId": "sess_123456789",
    "expiresAt": "2026-04-04T12:00:00Z"
}

Error Codes

400 - Bad Request (Invalid parameters)
401 - Unauthorized (Invalid API credentials)
404 - Game Not Found
429 - Rate Limit Exceeded
500 - Internal Server Error

Integration Examples

Click on any language below to see integration code:

PHP
JavaScript
Python
Java
C#
cURL
<?php
// Demo Endpoint (No authentication required)
$url = "https://rapidverse.site/api/demo";

// OR Production Endpoint (Authentication required)
// $url = "https://rapidverse.site/api/verse";

$data = [
    'userId' => 'YOUR_USER_ID',
    'gameCode' => 'YOUR_GAME_CODE',
    'userBalance' => 1000.00,
    'vendorCode' => 'JILI',
    'language' => '0',
    'phonetype' => '1',
    'returnUrl' => 'https://yourdomain.com/callback'
];

$headers = [
    'X-API-Token: YOUR_API_TOKEN',  // Required for production
    'X-Secret-Key: YOUR_SECRET_KEY', // Required for production
    'Content-Type: application/json'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode == 200 && isset($result['gameUrl'])) {
    header("Location: " . $result['gameUrl']);
} else {
    echo "Error: " . $response;
}
?>
// Demo Endpoint (No authentication required)
const url = "https://rapidverse.site/api/demo";

// OR Production Endpoint (Authentication required)
// const url = "https://rapidverse.site/api/verse";

const data = {
    userId: 'YOUR_USER_ID',
    gameCode: 'YOUR_GAME_CODE',
    userBalance: 1000.00,
    vendorCode: 'JILI',
    language: '0',
    phonetype: '1',
    returnUrl: 'https://yourdomain.com/callback'
};

const headers = {
    'X-API-Token': 'YOUR_API_TOKEN',  // Required for production
    'X-Secret-Key': 'YOUR_SECRET_KEY', // Required for production
    'Content-Type': 'application/json'
};

fetch(url, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => {
    if (data.status === 'success') {
        console.log('Game URL:', data.gameUrl);
        window.location.href = data.gameUrl;
    } else {
        console.error('API Error:', data);
    }
})
.catch(error => console.error('Error:', error));
import requests
import json

# Demo Endpoint (No authentication required)
url = "https://rapidverse.site/api/demo"

# OR Production Endpoint (Authentication required)
# url = "https://rapidverse.site/api/verse"

data = {
    "userId": "YOUR_USER_ID",
    "gameCode": "YOUR_GAME_CODE",
    "userBalance": 1000.00,
    "vendorCode": "JILI",
    "language": "0",
    "phonetype": "1",
    "returnUrl": "https://yourdomain.com/callback"
}

headers = {
    "X-API-Token": "YOUR_API_TOKEN",  # Required for production
    "X-Secret-Key": "YOUR_SECRET_KEY", # Required for production
    "Content-Type": "application/json"
}

response = requests.post(url, json=data, headers=headers)

if response.status_code == 200:
    result = response.json()
    if result.get("status") == "success":
        print(f"Game URL: {result['gameUrl']}")
    else:
        print(f"Error: {result}")
else:
    print(f"HTTP Error: {response.status_code}: {response.text}")
import java.net.http.*;
import java.net.URI;
import com.google.gson.Gson;
import java.util.*;

public class RapidverseAPI {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        
        // Demo Endpoint (No authentication required)
        String url = "https://rapidverse.site/api/demo";
        
        // OR Production Endpoint (Authentication required)
        // String url = "https://rapidverse.site/api/verse";
        
        Map<String, Object> data = new HashMap<>();
        data.put("userId", "YOUR_USER_ID");
        data.put("gameCode", "YOUR_GAME_CODE");
        data.put("userBalance", 1000.00);
        data.put("vendorCode", "JILI");
        data.put("language", "0");
        data.put("phonetype", "1");
        data.put("returnUrl", "https://yourdomain.com/callback");
        
        Gson gson = new Gson();
        String jsonBody = gson.toJson(data);
        
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(jsonBody));
        
        // Add authentication headers for production
        // requestBuilder.header("X-API-Token", "YOUR_API_TOKEN");
        // requestBuilder.header("X-Secret-Key", "YOUR_SECRET_KEY");
        
        HttpRequest request = requestBuilder.build();
        
        HttpResponse<String> response = client.send(request, 
            HttpResponse.BodyHandlers.ofString());
        
        System.out.println("Response: " + response.body());
    }
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main()
    {
        // Demo Endpoint (No authentication required)
        string url = "https://rapidverse.site/api/demo";
        
        // OR Production Endpoint (Authentication required)
        // string url = "https://rapidverse.site/api/verse";
        
        var data = new
        {
            userId = "YOUR_USER_ID",
            gameCode = "YOUR_GAME_CODE",
            userBalance = 1000.00,
            vendorCode = "JILI",
            language = "0",
            phonetype = "1",
            returnUrl = "https://yourdomain.com/callback"
        };
        
        string json = JsonConvert.SerializeObject(data);
        
        using (var client = new HttpClient())
        {
            // Add authentication headers for production
            // client.DefaultRequestHeaders.Add("X-API-Token", "YOUR_API_TOKEN");
            // client.DefaultRequestHeaders.Add("X-Secret-Key", "YOUR_SECRET_KEY");
            
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var response = await client.PostAsync(url, content);
            
            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine(responseBody);
        }
    }
}
# Demo Endpoint (No authentication required)
curl -X POST https://rapidverse.site/api/demo \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "YOUR_USER_ID",
    "gameCode": "YOUR_GAME_CODE",
    "userBalance": 1000.00,
    "vendorCode": "JILI",
    "language": "0",
    "phonetype": "1",
    "returnUrl": "https://yourdomain.com/callback"
  }'

# Production Endpoint (Authentication required)
curl -X POST https://rapidverse.site/api/verse \
  -H "X-API-Token: YOUR_API_TOKEN" \
  -H "X-Secret-Key: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "YOUR_USER_ID",
    "gameCode": "YOUR_GAME_CODE",
    "userBalance": 1000.00,
    "vendorCode": "JILI",
    "language": "0",
    "phonetype": "1",
    "returnUrl": "https://yourdomain.com/callback"
  }'

Download Example Code

Download complete PHP integration example file for quick setup:

Menu
Overview
API Endpoints
Integration Parameters
Game Launch Request
Response Format
Error Codes
Integration Examples
Download Example