📖 Grid Owner Resources

Documentazione API

Riferimento completo dell'API REST per l'integrazione delle grid OpenSimulator con ZoneCoin. Autentica, interroga i saldi, trasferisci fondi e gestisci le istanze via codice.

🌐 URL di base

https://zonecoin.zonenations.com/api/index.php/v1/zonecoin/dll

Tutte le richieste API devono essere inviate all'URL di base sottostante. Aggiungi il percorso dell'endpoint per costruire l'URL completo.

🔒 Autenticazione

La maggior parte degli endpoint richiede l'autenticazione con chiave API + segreto condiviso. Includi queste intestazioni in ogni richiesta autenticata.

# Intestazioni della richiesta
X-ZoneCoin-ApiKey: <your_api_key>
X-ZoneCoin-Secret: <your_shared_secret>
# Alternativa: firma HMAC
X-ZoneCoin-Signature: HMAC-SHA256(body, shared_secret)

⚡ Endpoint

GET /ping Health Check 🔓 Pubblico

Verifica che l'API sia attiva e risponda. Nessuna autenticazione richiesta.

Esempio di risposta 

{
    "success": true,
    "status": "alive",
    "service": "ZoneCoin DLL Helper",
    "currency": "ZoneCoin",
    "symbol": "ZC",
    "timestamp": "2026-02-17 12:00:00"
}
GET /balance Query Balance 🔒 Autenticazione richiesta

Interroga il saldo ZoneCoin di un avatar specifico.

Parametri

Nome Tipo Obbligatorio Descrizione
avatar_uuid string ✓ UUID dell'avatar in OpenSimulator

Esempio di risposta 

{
    "success": true,
    "balance": 1500,
    "currency": "ZC"
}
POST /transfer Transfer Funds 🔒 Autenticazione richiesta

Trasferisci ZoneCoin tra due avatar. Le commissioni vengono applicate automaticamente.

Parametri

Nome Tipo Obbligatorio Descrizione
sender_uuid string ✓ UUID dell'avatar mittente
receiver_uuid string ✓ UUID dell'avatar destinatario
amount float ✓ Importo da trasferire/acquistare/vendere
description string — Descrizione opzionale della transazione

Esempio di risposta 

{
    "success": true,
    "tx_hash": "abc123...",
    "net_amount": 99.5,
    "fee": 0.5
}
POST /buy Buy Currency 🔒 Autenticazione richiesta

Acquista ZoneCoin per un account avatar.

Parametri

Nome Tipo Obbligatorio Descrizione
avatar_uuid string ✓ UUID dell'avatar in OpenSimulator
amount float ✓ Importo di ZoneCoin da acquistare

Esempio di risposta 

{
    "success": true,
    "credited": 1000,
    "cost_usd": 10
}
POST /sell Sell Currency 🔒 Autenticazione richiesta

Vendi ZoneCoin da un account avatar alla piattaforma.

Parametri

Nome Tipo Obbligatorio Descrizione
avatar_uuid string ✓ UUID dell'avatar in OpenSimulator
amount float ✓ Importo di ZoneCoin da vendere

Esempio di risposta 

{
    "success": true,
    "deducted": 500,
    "payout_usd": 5
}
GET /discover Discover Instances 🔒 Autenticazione richiesta

Elenca tutte le istanze di grid attive registrate sulla piattaforma.

Esempio di risposta 

{
    "success": true,
    "instances": [
        {
            "uuid": "...",
            "name": "MyGrid",
            "status": "active",
            "online_users": 12
        }
    ],
    "count": 1
}
POST /register Register Instance 🔒 Autenticazione richiesta

Registra una nuova istanza OpenSimulator sulla piattaforma.

Parametri

Nome Tipo Obbligatorio Descrizione
name string ✓ Nome dell'istanza OpenSimulator
base_url string ✓ URL di base dell'istanza OpenSimulator

Esempio di risposta 

null
POST /currencyServer Currency Server (Legacy Migration) 🔒 Autenticazione richiesta

Endpoint economia nativa ZoneCoin. Supporta le azioni balance, transfer, buy, sell, pay_object e land_buy tramite il Modulo OpenSim ZoneCoin.

Parametri

Nome Tipo Obbligatorio Descrizione
method string ✓ Nome dell'azione (balance, transfer, buy, sell, ecc.)
agentId string — ID agente (mappato su avatar_uuid)
amount float — Importo da trasferire/acquistare/vendere

Esempio di risposta 

{
    "success": true,
    "balance": 1500
}
POST /landTool Land Tool 🔒 Autenticazione richiesta

Elabora transazioni di acquisto terreni dall'interno di OpenSimulator.

Parametri

Nome Tipo Obbligatorio Descrizione
avatar_uuid string ✓ UUID dell'avatar in OpenSimulator
amount float ✓ Importo da trasferire/acquistare/vendere
region string — Nome della regione per operazioni sui terreni

Esempio di risposta 

{
    "success": true,
    "tx_hash": "land_abc123..."
}

⏳ Limiti di frequenza

Endpoint standard60 req/min
Interrogazioni saldo120 req/min
Trasferimenti30 req/min
Controllo salute (ping)Illimitato

⚠ Codici di errore

Code Descrizione
200Successo - richiesta completata
400Richiesta non valida - parametri mancanti o non validi
401Non autorizzato - chiave API o segreto non validi
429Troppe richieste - limite di frequenza superato
500Errore interno del server
503Servizio non disponibile - API o integrazione DLL disabilitata

🚀 Link rapidi

🏠 Dashboard Grid Owner ⚙ Modulo DLL 🌐 Registrati come Grid Owner