API-Dokumentation

ZoneNations

📖 Grid Owner Resources

Vollständige REST API-Referenz für die Integration von OpenSimulator-Grids mit ZoneCoin. Authentifizieren, Salden abfragen, Geldmittel überweisen und Instanzen programmatisch verwalten.

🌐 Basis-URL

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

Alle API-Anfragen sollten an die unten stehende Basis-URL gesendet werden. Hängen Sie den Endpunkt-Pfad an, um die vollständige URL zu erstellen.

🔒 Authentifizierung

Die meisten Endpunkte erfordern eine Authentifizierung mit API Key + Shared Secret. Fügen Sie diese Header in jede authentifizierte Anfrage ein.

# Anfrage-Header
X-ZoneCoin-ApiKey: <your_api_key>
X-ZoneCoin-Secret: <your_shared_secret>
# Alternative: HMAC-Signatur
X-ZoneCoin-Signature: HMAC-SHA256(body, shared_secret)

⚡ Endpunkte

GET /ping Health Check 🔓 Öffentlich

Prüfen, ob die API aktiv ist und antwortet. Keine Authentifizierung erforderlich.

Antwortbeispiel

{
    "success": true,
    "status": "alive",
    "service": "ZoneCoin DLL Helper",
    "currency": "ZoneCoin",
    "symbol": "ZC",
    "timestamp": "2026-02-17 12:00:00"
}

GET /balance Query Balance 🔒 Authentifizierung erforderlich

ZoneCoin-Saldo eines bestimmten Avatars abfragen.

Parameter

Name	Typ	Erforderlich	Beschreibung
`avatar_uuid`	string	✓	UUID des Avatars in OpenSimulator

Antwortbeispiel

{
    "success": true,
    "balance": 1500,
    "currency": "ZC"
}

POST /transfer Transfer Funds 🔒 Authentifizierung erforderlich

ZoneCoin zwischen zwei Avataren überweisen. Gebühren werden automatisch angewendet.

Parameter

Name	Typ	Erforderlich	Beschreibung
`sender_uuid`	string	✓	UUID des sendenden Avatars
`receiver_uuid`	string	✓	UUID des empfangenden Avatars
`amount`	float	✓	Betrag zum Überweisen/Kaufen/Verkaufen
`description`	string	—	Optionale Transaktionsbeschreibung

Antwortbeispiel

{
    "success": true,
    "tx_hash": "abc123...",
    "net_amount": 99.5,
    "fee": 0.5
}

POST /buy Buy Currency 🔒 Authentifizierung erforderlich

ZoneCoin für ein Avatar-Konto kaufen.

Parameter

Name	Typ	Erforderlich	Beschreibung
`avatar_uuid`	string	✓	UUID des Avatars in OpenSimulator
`amount`	float	✓	Menge an ZoneCoin zum Kaufen

Antwortbeispiel

{
    "success": true,
    "credited": 1000,
    "cost_usd": 10
}

POST /sell Sell Currency 🔒 Authentifizierung erforderlich

ZoneCoin von einem Avatar-Konto an die Plattform zurückverkaufen.

Parameter

Name	Typ	Erforderlich	Beschreibung
`avatar_uuid`	string	✓	UUID des Avatars in OpenSimulator
`amount`	float	✓	Menge an ZoneCoin zum Verkaufen

Antwortbeispiel

{
    "success": true,
    "deducted": 500,
    "payout_usd": 5
}

GET /discover Discover Instances 🔒 Authentifizierung erforderlich

Alle aktiven, auf der Plattform registrierten Grid-Instanzen auflisten.

Antwortbeispiel

{
    "success": true,
    "instances": [
        {
            "uuid": "...",
            "name": "MyGrid",
            "status": "active",
            "online_users": 12
        }
    ],
    "count": 1
}

POST /register Register Instance 🔒 Authentifizierung erforderlich

Eine neue OpenSimulator-Instanz auf der Plattform registrieren.

Parameter

Name	Typ	Erforderlich	Beschreibung
`name`	string	✓	Name der OpenSimulator-Instanz
`base_url`	string	✓	Basis-URL der OpenSimulator-Instanz

Antwortbeispiel

null

POST /currencyServer Currency Server (Legacy Migration) 🔒 Authentifizierung erforderlich

Nativer ZoneCoin-Wirtschaftsendpunkt. Unterstützt balance, transfer, buy, sell, pay_object und land_buy Aktionen über das ZoneCoin OpenSim-Modul.

Parameter

Name	Typ	Erforderlich	Beschreibung
`method`	string	✓	Aktionsname (balance, transfer, buy, sell, usw.)
`agentId`	string	—	Agent-ID (auf avatar_uuid gemappt)
`amount`	float	—	Betrag zum Überweisen/Kaufen/Verkaufen

Antwortbeispiel

{
    "success": true,
    "balance": 1500
}

POST /landTool Land Tool 🔒 Authentifizierung erforderlich

Landkauftransaktionen innerhalb von OpenSimulator verarbeiten.

Parameter

Name	Typ	Erforderlich	Beschreibung
`avatar_uuid`	string	✓	UUID des Avatars in OpenSimulator
`amount`	float	✓	Betrag zum Überweisen/Kaufen/Verkaufen
`region`	string	—	Regionsname für Landoperationen

Antwortbeispiel

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

⏳ Ratenbegrenzung

Standard-Endpunkte	60 req/min
Saldoabfragen	120 req/min
Überweisungen	30 req/min
Healthcheck (Ping)	Unbegrenzt

⚠ Fehlercodes

Code	Beschreibung
200	Erfolg - Anfrage abgeschlossen
400	Ungültige Anfrage — fehlende oder ungültige Parameter
401	Nicht autorisiert — ungültiger API Key oder Secret
429	Zu viele Anfragen — Ratenlimit überschritten
500	Interner Serverfehler
503	Dienst nicht verfügbar — API- oder DLL-Integration deaktiviert

🚀 Schnelllinks

🏠 Grid-Owner-Dashboard ⚙ DLL-Modul 🌐 Als Grid-Owner registrieren