GET /apiv2/order_check

Maliyet dökümü, aktivasyon ayrıntıları ve alt kullanıcı kâr marjı bilgileri dahil olmak üzere belirli bir 1 saatlik energy siparişi hakkında ayrıntılı bilgileri alın.

Uç Nokta URL'si

GET https://netts.io/apiv2/order_check

İstek Başlıkları

Başlık	Gerekli	Açıklama
X-API-KEY	Evet	Netts kontrol panelindeki API anahtarınız

Sorgu Parametreleri

Parametre	Tür	Gerekli	Açıklama
order_id	string	Evet	1H{hash} biçiminde Sipariş Kimliği (örn. 1Ha1b2c3d4e5)

Örnek İstekler

cURL

curl -X GET "https://netts.io/apiv2/order_check?order_id=1Ha1b2c3d4e5" \
  -H "X-API-KEY: your_api_key"

Python

import requests

url = "https://netts.io/apiv2/order_check"
headers = {
    "X-API-KEY": "your_api_key"
}
params = {
    "order_id": "1Ha1b2c3d4e5"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

if data.get("success"):
    order = data.get("order", {})
    print(f"Order ID: {order.get('id')}")
    print(f"Total Cost: {order.get('cost')} TRX")
    print(f"Energy: {order.get('energy')}")
    print(f"Rate: {order.get('rate_sun')} sun/energy")
    print(f"Target Address: {order.get('target_address')}")

    # Check if activation was performed
    activation = data.get("activation")
    if activation:
        print(f"Activation Cost: {activation.get('cost')} TRX")
        print(f"Activation Hash: {activation.get('tx_hash')}")
else:
    print(f"Error: {data.get('msg')}")

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://netts.io/apiv2/order_check';
const headers = {
    'X-API-KEY': 'your_api_key'
};
const params = {
    order_id: '1Ha1b2c3d4e5'
};

axios.get(url, { headers, params })
    .then(response => {
        const data = response.data;
        if (data.success) {
            console.log('Order:', data.order);
            console.log('Activation:', data.activation);
        } else {
            console.log('Error:', data.msg);
        }
    })
    .catch(error => console.error('Request failed:', error));

Yanıt

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

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 2.535,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678"],
        "timestamp": "2025-12-03T15:21:34.182127",
        "rate_sun": 39.0,
        "comments": null
    },
    "activation": null,
    "subuser_payout": null
}

Aktivasyon İçeren Başarılı Yanıt (200 OK)

Hedef adres aktivasyon gerektirdiğinde:

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 3.635,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678"],
        "timestamp": "2025-12-03T15:21:34.182127",
        "rate_sun": 39.0,
        "comments": "Includes activation: 1.1 TRX"
    },
    "activation": {
        "cost": 1.1,
        "tx_hash": "b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789a"
    },
    "subuser_payout": null
}

Alt Kullanıcı Ödemesi İçeren Başarılı Yanıt (200 OK)

Alt kullanıcı siparişlerini görüntüleyen üst kullanıcılar için:

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 3.93,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789abc"],
        "timestamp": "2025-12-03T16:55:16.525118",
        "rate_sun": 60.5,
        "comments": "Includes activation: 1.1 TRX"
    },
    "activation": {
        "cost": 1.1,
        "tx_hash": "b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789a"
    },
    "subuser_payout": {
        "parent_id": 12,
        "gross_cost": 3.93,
        "energy_markup": 0.195,
        "activation_markup": 0.1,
        "total_markup": 0.295,
        "net_cost": 3.635,
        "subuser_rate_sun": 43.5,
        "parent_rate_sun": 39.0
    }
}

Yanıt Alanları

Ana Yanıt

Alan	Tür	Açıklama
success	boolean	İstek başarılıysa true
code	integer	Başarılı istekler için 10000
order	object	Sipariş ayrıntıları
activation	object | null	Aktivasyon ayrıntıları (adres aktive edildiyse)
subuser_payout	object | null	Alt kullanıcı kâr marjı ayrıntıları (yalnızca üst kullanıcılar için)

Order Nesnesi

Alan	Tür	Açıklama
id	string	1H{hash} biçiminde Sipariş Kimliği
cost	number	Kullanıcı tarafından ödenen toplam maliyet (TRX)
target_address	string	Energy alan adres
energy	integer	Delege edilen Energy miktarı
duration	string	Delegasyon süresi (her zaman "1 hour")
tx_hashes	array	Delegasyon işlem karmaları listesi
timestamp	string	Sipariş oluşturma zamanı (ISO 8601 biçiminde)
rate_sun	number	Energy birimi başına sun cinsinden Energy oranı
comments	string | null	Ek bilgiler (örn. aktivasyon bildirimi)

Activation Nesnesi

Alan	Tür	Açıklama
cost	number	Aktivasyon maliyeti (TRX)
tx_hash	string	Aktivasyon işlem karması

Subuser Payout Nesnesi

Yalnızca Üst Kullanıcılar

subuser_payout alanı yalnızca alt kullanıcılarının siparişlerini görüntüleyen üst kullanıcılar için dahil edilir. Alt kullanıcılar (sahte kullanıcılar) bu alanı görmez.

Alan	Tür	Açıklama
parent_id	integer	Üst kullanıcı kimliği
gross_cost	number	Alt kullanıcı tarafından ödenen toplam maliyet (TRX)
energy_markup	number	Energy kâr marjı tutarı (TRX)
activation_markup	number	Aktivasyon kâr marjı tutarı (TRX)
total_markup	number	Toplam kâr marjı (energy + aktivasyon)
net_cost	number	Kâr marjı düşülmüş maliyet (üst kullanıcının gerçek maliyeti)
subuser_rate_sun	number	Alt kullanıcı tarafından ödenen oran (sun/energy)
parent_rate_sun	number	Kâr marjı hariç gerçek oran (sun/energy)

Hata Yanıtları

Eksik Sipariş Kimliği (400)

{
    "success": false,
    "code": -2,
    "msg": "order_id parameter required"
}

Kimlik Doğrulama Hatası (401)

{
    "success": false,
    "code": -1,
    "msg": "API key not provided"
}

{
    "success": false,
    "code": -1,
    "msg": "Invalid API key or IP not in whitelist"
}

Erişim Reddedildi (403)

Başka bir kullanıcıya ait bir sipariş görüntülenmeye çalışıldığında:

{
    "success": false,
    "code": -4,
    "msg": "Order does not belong to this user"
}

Sipariş Bulunamadı (404)

{
    "success": false,
    "code": -3,
    "msg": "Order not found"
}

Sunucu İçi Hata (500)

{
    "success": false,
    "msg": "Internal server error"
}

Hata Kodu Referansı

Kod	Açıklama	HTTP Durumu
10000	Başarılı	200
-1	Kimlik doğrulama başarısız oldu	401
-2	Eksik order_id parametresi	400
-3	Sipariş bulunamadı	404
-4	Erişim reddedildi (sipariş size ait değil)	403

İstek Limitleri

Bu uç nokta için aşağıdaki istek limitleri geçerlidir (IP adresi başına):

Süre	Limit	Açıklama
1 saniye	50 istek	Saniyede en fazla 50 istek

İstek Limiti Başlıkları

RateLimit-Limit: 50
RateLimit-Remaining: 49
RateLimit-Reset: 1
X-RateLimit-Limit-Second: 50
X-RateLimit-Remaining-Second: 49

İstek Limiti Aşıldı (429)

{
    "message": "API rate limit exceeded"
}

Erişim Kontrolü

Sipariş Sahipliği

Kullanıcılar yalnızca kendi siparişlerini görüntüleyebilir. API, sahipliği şunlara göre kontrol eder:

• Google kullanıcıları: Siparişteki google_user_id ile kullanıcının Google Kimliğini eşleştirir
• Telegram kullanıcıları: Siparişteki tg_user_id ile kullanıcının Telegram Kimliğini eşleştirir

Üst-Alt Kullanıcı Erişimi

Üst kullanıcılar, alt kullanıcıları tarafından oluşturulan siparişleri görüntüleyebilir. Bu durumda:

• Yanıta subuser_payout alanı dahil edilir
• Üst kullanıcı kâr marjı dökümünü ve kendi gerçek maliyetini görebilir

Alt Kullanıcı (Sahte) Erişimi

Kendi siparişlerini görüntüleyen alt kullanıcılar şunları görür:

• order.cost içinde gerçek maliyetleri (kâr marjı dahil)
• order.rate_sun içinde oranları (kâr marjı dahil)
• subuser_payout alanı dahil edilmez

Kullanım Senaryoları

1. Sipariş Tamamlanmasını Doğrulama

/apiv2/order1h ile bir sipariş verdikten sonra şunları doğrulamak için bu uç noktayı kullanın:

• Sipariş başarıyla işlendi
• Energy doğru adrese delege edildi
• Doğru tutar tahsil edildi

2. İşlem Karmasını Alma

Blokzincir doğrulaması için delegasyon işlem karmasını alın:

response = requests.get(
    "https://netts.io/apiv2/order_check",
    headers={"X-API-KEY": "your_api_key"},
    params={"order_id": "1Ha1b2c3d4e5"}
)

data = response.json()
if data["success"]:
    tx_hashes = data["order"]["tx_hashes"]
    if tx_hashes:
        print(f"Verify on Tronscan: https://tronscan.org/#/transaction/{tx_hashes[0]}")

3. Alt Kullanıcı Maliyetlerini Takip Etme (Üst Kullanıcılar)

Üst kullanıcılar, alt kullanıcılarının siparişlerini ve kâr marjı kazançlarını izleyebilir:

response = requests.get(
    "https://netts.io/apiv2/order_check",
    headers={"X-API-KEY": "parent_api_key"},
    params={"order_id": "1Ha1b2c3d4e5"}
)

data = response.json()
if data["success"] and data.get("subuser_payout"):
    payout = data["subuser_payout"]
    print(f"Subuser paid: {payout['gross_cost']} TRX")
    print(f"Your markup: {payout['total_markup']} TRX")
    print(f"Your actual cost: {payout['net_cost']} TRX")

Notlar

• Siparişler oluşturulduktan hemen sonra sorgulanabilir
• Sağlayıcı işlem karmalarını döndürmezse bunlar boş olabilir
• rate_sun alanı sun cinsinden Energy birimi başına geçerli oranı gösterir
• Geçerli olduğunda aktivasyon maliyeti toplam cost değerine dahil edilir
• comments alanı ek bağlam sağlar (örn. aktivasyon bildirimi)
• Bu uç nokta yalnızca /apiv2/order1h aracılığıyla oluşturulan 1 saatlik siparişleri döndürür