📖 Grid Owner Resources

APIドキュメント

OpenSimulatorグリッドとZoneCoinを統合するための完全なREST APIリファレンスです。認証、残高照会、資金送金、インスタンス管理をプログラムで実行できます。

🌐 ベースURL

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

すべてのAPIリクエストは以下のベースURLに送信してください。エンドポイントパスを追加して完全なURLを構成します。

🔒 認証

ほとんどのエンドポイントはAPIキー＋共有シークレットによる認証が必要です。認証済みリクエストごとにこれらのヘッダーを含めてください。

# リクエストヘッダー
X-ZoneCoin-ApiKey: <your_api_key>
X-ZoneCoin-Secret: <your_shared_secret>
# 代替：HMAC署名
X-ZoneCoin-Signature: HMAC-SHA256(body, shared_secret)

⚡ エンドポイント

GET /ping Health Check 🔓 公開

APIが稼働中で応答しているか確認します。認証は不要です。

レスポンス例 

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

特定のアバターのZoneCoin残高を照会します。

パラメータ

名前 タイプ 必須 説明
avatar_uuid string ✓ OpenSimulatorのアバターUUID

レスポンス例 

{
    "success": true,
    "balance": 1500,
    "currency": "ZC"
}
POST /transfer Transfer Funds 🔒 認証必須

2つのアバター間でZoneCoinを送金します。手数料は自動的に適用されます。

パラメータ

名前 タイプ 必須 説明
sender_uuid string ✓ 送信アバターのUUID
receiver_uuid string ✓ 受信アバターのUUID
amount float ✓ 送金/購入/売却する金額
description string — 任意の取引説明

レスポンス例 

{
    "success": true,
    "tx_hash": "abc123...",
    "net_amount": 99.5,
    "fee": 0.5
}
POST /buy Buy Currency 🔒 認証必須

アバターアカウント用にZoneCoinを購入します。

パラメータ

名前 タイプ 必須 説明
avatar_uuid string ✓ OpenSimulatorのアバターUUID
amount float ✓ 購入するZoneCoinの金額

レスポンス例 

{
    "success": true,
    "credited": 1000,
    "cost_usd": 10
}
POST /sell Sell Currency 🔒 認証必須

アバターアカウントからプラットフォームへZoneCoinを売却します。

パラメータ

名前 タイプ 必須 説明
avatar_uuid string ✓ OpenSimulatorのアバターUUID
amount float ✓ 売却するZoneCoinの金額

レスポンス例 

{
    "success": true,
    "deducted": 500,
    "payout_usd": 5
}
GET /discover Discover Instances 🔒 認証必須

プラットフォームに登録されているすべてのアクティブなグリッドインスタンスを一覧表示します。

レスポンス例 

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

プラットフォームに新しいOpenSimulatorインスタンスを登録します。

パラメータ

名前 タイプ 必須 説明
name string ✓ OpenSimulatorインスタンス名
base_url string ✓ OpenSimulatorインスタンスのベースURL

レスポンス例 

null
POST /currencyServer Currency Server (Legacy Migration) 🔒 認証必須

ZoneCoinネイティブ経済エンドポイント。ZoneCoin OpenSimモジュールを通じてbalance、transfer、buy、sell、pay_object、land_buyアクションをサポートします。

パラメータ

名前 タイプ 必須 説明
method string ✓ アクション名（balance、transfer、buy、sellなど）
agentId string — エージェントID（avatar_uuidにマッピング）
amount float — 送金/購入/売却する金額

レスポンス例 

{
    "success": true,
    "balance": 1500
}
POST /landTool Land Tool 🔒 認証必須

OpenSimulator内から土地購入トランザクションを処理します。

パラメータ

名前 タイプ 必須 説明
avatar_uuid string ✓ OpenSimulatorのアバターUUID
amount float ✓ 送金/購入/売却する金額
region string — 土地操作のリージョン名

レスポンス例 

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

⏳ レート制限

標準エンドポイント60 req/min
残高照会120 req/min
送金30 req/min
ヘルスチェック（ping）無制限

⚠ エラーコード

Code 説明
200成功 — リクエスト完了
400不正リクエスト — パラメータ不足または無効
401未認証 — APIキーまたはシークレットが無効
429リクエスト過多 — レート制限を超過しました
500内部サーバーエラー
503サービス利用不可 — APIまたはDLL統合が無効

🚀 クイックリンク

🏠 グリッドオーナーダッシュボード ⚙ DLLモジュール 🌐 グリッドオーナーとして登録