POST /apiv2/subusergen

Ana hesabınıza bağlı yeni bir SUB-kullanıcı (alt hesap) oluşturun. SUB-kullanıcılar, bağımsız Energy işlemleri için kendi API anahtarlarına, para yatırma adreslerine ve ayrı bir bakiyeye sahiptir.

Uç Nokta URL'si

POST https://netts.io/apiv2/subusergen

İstek Başlıkları

Header	Required	Description
Content-Type	Evet	application/json
X-API-KEY	Evet	Netts kontrol panelinizdeki API anahtarınız
X-Real-IP	Evet	Beyaz listenizdeki IP adresi

İstek Gövdesi

{}

Parametre gerekmez. SUB-kullanıcı, API anahtarı ile tanımlanan hesaba otomatik olarak bağlanır.

Örnek İstekler

cURL

curl -X POST https://netts.io/apiv2/subusergen \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{}'

Python

import requests

url = "https://netts.io/apiv2/subusergen"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

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

if response.status_code == 200:
    print(f"SUB User ID: {data['user_id']}")
    print(f"Google ID: {data['google_id']}")
    print(f"Email: {data['email']}")
    print(f"Deposit Address: {data['deposit_address']}")
    print(f"API Key: {data['api_key']}")
    print(f"Referral Code: {data['referral_code']}")
    print(f"Parent User ID: {data['referrer_user_id']}")
else:
    print(f"Error: {data.get('detail', 'Unknown error')}")

Node.js

const axios = require('axios');

async function createSubUser(apiKey, whitelistedIp) {
    const url = 'https://netts.io/apiv2/subusergen';

    const response = await axios.post(url, {}, {
        headers: {
            'Content-Type': 'application/json',
            'X-API-KEY': apiKey,
            'X-Real-IP': whitelistedIp
        },
        timeout: 30000
    });

    const data = response.data;
    console.log(`SUB User ID: ${data.user_id}`);
    console.log(`API Key: ${data.api_key}`);
    console.log(`Deposit Address: ${data.deposit_address}`);
    return data;
}

// Usage
createSubUser('your_api_key', 'your_whitelisted_ip')
    .then(result => console.log('Created:', result))
    .catch(err => console.error('Error:', err.response?.data || err.message));

PHP

<?php
$url = 'https://netts.io/apiv2/subusergen';

$options = [
    'http' => [
        'header' => implode("\r\n", [
            "Content-Type: application/json",
            "X-API-KEY: your_api_key",
            "X-Real-IP: your_whitelisted_ip"
        ]),
        'method' => 'POST',
        'content' => '{}',
        'timeout' => 30
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);

echo "SUB User ID: {$data['user_id']}\n";
echo "API Key: {$data['api_key']}\n";
echo "Deposit Address: {$data['deposit_address']}\n";
?>

Yanıt

Başarılı Yanıt (200 OK)

{
    "user_id": 1379,
    "google_id": "SUB123456789012345678",
    "email": "[email protected]",
    "name": "SUB123456789012345678",
    "deposit_address": "TExampleAddress1234567890123456789",
    "api_key": "mock1234567890abcdef1234567890ab",
    "referral_code": "A2B4K9",
    "created_at": "2026-03-14T12:00:00",
    "referrer_user_id": 42,
    "comment": "SUB user linked to main user (referrer_user_id). Google ID, Email and Name are mock data (not real) that can be updated via separate endpoint. For API services usage, requests must include this SUB user's API key and IP from main user's whitelist. Calculations use SUB user's balance. Generated deposit address is not active."
}

Yanıt Alanları

Field	Type	Description
user_id	integer	Oluşturulan SUB-kullanıcının benzersiz kimliği
google_id	string	Sahte tanımlayıcı (biçim: SUB + 18 hane). Gerçek bir Google hesabı değildir — yalnızca SUB-kullanıcının dahili tanımlaması için kullanılır
email	string	Sahte e-posta (google_id + @gmail.com). Gerçek bir e-posta adresi değildir — yalnızca dahili tanımlama için kullanılır
name	string	Görünen ad (varsayılan olarak google_id). Kontrol panelinden değiştirilebilir
deposit_address	string	Oluşturulan TRON para yatırma adresi (varsayılan olarak aktif değildir)
api_key	string	SUB-kullanıcı için API anahtarı (mock öneki)
referral_code	string	Oluşturulan referans kodu (6 karakter)
created_at	string	ISO 8601 biçiminde oluşturulma zaman damgası
referrer_user_id	integer	Üst kullanıcı kimliği (bu SUB-kullanıcıyı oluşturan hesap)
comment	string	Kullanım talimatları ve notlar

Sahte Google Verileri

google_id, email ve name alanları sahte verilerdir — gerçek Google hesapları veya e-posta adresleri değildir. Bu alanlar yalnızca SUB-kullanıcının sistem içinde dahili olarak tanımlanması için mevcuttur. Bir SUB-kullanıcının adı ve etiketi kontrol panelinden değiştirilebilir.

SUB-Kullanıcılar Nasıl Çalışır?

Temel Kavramlar

• Ayrı bakiye: Her SUB-kullanıcının üst hesaptan bağımsız kendi TRX bakiyesi vardır
• Paylaşılan IP beyaz listesi: SUB-kullanıcı API istekleri, üst hesabın IP beyaz listesine göre doğrulanır
• Kendi API anahtarı: Her SUB-kullanıcı kimlik doğrulama için benzersiz bir API anahtarı alır
• Üst hesap bağlantısı: SUB-kullanıcı, referans sistemi aracılığıyla oluşturan hesaba kalıcı olarak bağlanır
• Tüm API uç noktaları: SUB-kullanıcılar, kendi API anahtarları ve bakiyeleri ile tüm API uç noktalarını (order1h, time/order vb.) kullanabilir

Kullanım Akışı

1. Bu uç nokta üzerinden SUB-kullanıcı oluşturun
2. Para yatırma adresine TRX yatırarak veya bakiye aktararak SUB-kullanıcıya bakiye yükleyin
3. Sonraki API isteklerinde (order1h, time/order vb.) SUB-kullanıcının API anahtarını kullanın
4. SUB-kullanıcının API anahtarını kullanarak userinfo uç noktası üzerinden izleyin

Hata Yanıtları

Kimlik Doğrulama Hatası (401)

{
    "detail": "X-API-KEY header required"
}

Yetkisiz Erişim (403)

{
    "detail": "Invalid API key or IP not whitelisted"
}

Doğrulama Hatası (422)

{
    "detail": [...],
    "body": {...}
}

Sunucu İçi Hata (500)

{
    "detail": "Failed to create mock user: ..."
}

Hata Kodu Referansı

HTTP Status	Description
200	SUB-kullanıcı başarıyla oluşturuldu
401	Eksik API anahtarı başlığı
403	Geçersiz API anahtarı veya IP beyaz listede değil
422	İstek doğrulama hatası
500	Sunucu içi hata

Notlar

• Boş istek gövdesi {} gereklidir (Content-Type application/json olmalıdır)
• Oluşturulan para yatırma adresi varsayılan olarak aktif değildir
• SUB-kullanıcının google_id ve email alanları sahte verilerdir (gerçek Google hesapları değildir), yalnızca dahili tanımlama için kullanılır
• SUB-kullanıcının adı ve etiketi kontrol panelinden değiştirilebilir
• SUB-kullanıcının API anahtarı mock öneki ile başlar
• IP beyaz listesi doğrulaması üst kullanıcının beyaz listesini kullanır
• Her SUB-kullanıcının üst hesaptan ayrı kendi bakiyesi vardır
• SUB-kullanıcılar DELETE /apiv2/subuserdel uç noktası üzerinden silinebilir
• Para yatırma adresi POST /apiv2/address/rotate uç noktası üzerinden yenilenebilir