Public API

Fetch live connection details for any deployment server IPs, database hosts, API URLs. All requests secured with HMAC-SHA256.

Getting Started

How It Works

01 Get your credentials

Copy your appKey and appSecret from the dashboard.

02 Sign your request

Generate an HMAC-SHA256 signature using appKey:timestamp.

03 Call the endpoint

Send a POST request with appKey, timestamp, and signature.

04 Get live details

Receive current IPs, ports, URLs, and status.

Reference

Available Endpoints

POST /api/PublicServer/GetServerInfo

IPs, ports, and WebSocket URLs for all running server containers.

POST /api/PublicServer/GetWorkerServerInfo

All running worker server containers grouped by region.

POST /api/PublicServer/GetApiDeploymentInfo

Stable API base URL, WebSocket URL, and custom domain.

POST /api/PublicServer/GetDatabaseInfo

Live database connection details — write host/port, read replicas.

POST /api/PublicServer/GetWebsiteInfo

Website URL and custom domain for your website deployment.

HMAC-SHA256 Signed

Every request must include a valid signature.

Timestamp Tolerance

Requests must be within ±5 minutes of server time.

Rate Limited

30 requests per minute per IP address.

No Login Required

Designed for server-to-server and client-to-server calls.

Security

Code Example

Get Server Connection Details (Python)

import hmac, hashlib, datetime, requests

app_key = "your-app-key"
app_secret = "your-app-secret"

# Step 1: Generate timestamp and signature

timestamp = datetime.datetime.utcnow().isoformat() + "Z"
message = f"{app_key}:{timestamp}"

signature = hmac.new(app_secret.encode(), message.encode(), hashlib.sha256).hexdigest()

# Step 2: Call the public API

response = requests.post(

    "https://api.multiconnectcloud.com/api/PublicServer/GetServerInfo",

    json={

        "appKey": app_key,
        "timestamp": timestamp,
        "signature": signature

    }
)

data = response.json()

for server in data["servers"]:

    print(f"Region: {server['regionName']} | IP: {server['ip']}:{server['port']} | Healthy: {server['isHealthy']}")

Get Server Connection Details (C#)

var appKey = "your-app-key";
var appSecret = "your-app-secret";
var timestamp = DateTime.UtcNow.ToString("o");
var message = $"{appKey}:{timestamp}";

using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(appSecret)); var signature = Convert.ToHexString(hmac.ComputeHash(Encoding.UTF8.GetBytes(message))).ToLower();

var response = await httpClient.PostAsJsonAsync(

    "https://api.multiconnectcloud.com/api/PublicServer/GetServerInfo",

    new { appKey, timestamp, signature }

);

Get Database Connection String (Node.js)

const crypto = require('crypto');

const appKey = 'your-app-key';
const appSecret = 'your-app-secret';
const timestamp = new Date().toISOString();

const signature = crypto.createHmac('sha256', appSecret)
.update(`${appKey}:${timestamp}`).digest('hex');

const response = await fetch(

    'https://api.multiconnectcloud.com/api/PublicServer/GetDatabaseInfo', {

        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ appKey, timestamp, signature })

    }
);

const data = await response.json();

console.log(`Write host: ${data.writeHost}:${data.writePort}`);

console.log(`Connection: ${data.writeConnectionString}`);

Use Cases

When to Use the Public API

Client Applications

Discover available servers at runtime, automatically, dynamically, instantly

Server-to-Server

Query running containers for routing or load distribution efficiently dynamically.

Backend Services

Resolve database connection strings on startup automatically securely

Mobile/Web Apps

Deploy up to 10 containers per region across all deployment types.

DevOps Scripts

Verify deployments are running and healthy, reliably, continuously, accurately.

Frequently Asked Questions

Everything you need to know about MultiConnect Cloud.

How do I connect to my deployments from code?

Use the Public API endpoints to fetch live connection details. Sign your requests with HMAC-SHA256 using your app’s key and secret. No user login required – works for server-to-server and client-to-server calls.

What connection details can I get from the Public API?

Server IPs/ports/WebSocket URLs, API base URLs and custom domains, database write/read hosts with connection strings, and website URLs with custom domains.

What happens if my database moves to a new host?

The GetDatabaseInfo endpoint always returns the latest connection details automatically. You can also configure a webhook to receive a POST notification whenever connection details change.