GET /apiv2/order_check

کسی مخصوص 1 گھنٹے کے Energy آرڈر کے بارے میں تفصیلی معلومات حاصل کریں، بشمول لاگت کی تفصیل، ایکٹیویشن کی تفصیلات، اور ذیلی صارف (subuser) کے مارک اپ کی معلومات۔

اینڈ پوائنٹ URL

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

درخواست کے ہیڈرز (Request Headers)

ہیڈر	ضروری ہے	تفصیل
X-API-KEY	ہاں	آپ کی API کلید Netts ڈیش بورڈ سے

کوئری پیرامیٹرز (Query Parameters)

پیرامیٹر	قسم	ضروری ہے	تفصیل
order_id	string	ہاں	آرڈر ID فارمیٹ 1H{hash} میں (مثال کے طور پر، 1Ha1b2c3d4e5)

نمونہ درخواستیں (Example Requests)

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));

جواب (Response)

کامیاب جواب (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
}

ایکٹیویشن کے ساتھ کامیاب جواب (200 OK)

جب ہدف کے پتے کو ایکٹیویشن کی ضرورت تھی:

{
    "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
}

ذیلی صارف کے پے آؤٹ کے ساتھ کامیاب جواب (200 OK)

پیرنٹ صارفین کے لیے جو ذیلی صارفین کے آرڈرز دیکھ رہے ہیں:

{
    "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
    }
}

جواب کے فیلڈز (Response Fields)

بنیادی جواب (Main Response)

فیلڈ	قسم	تفصیل
success	boolean	اگر درخواست کامیاب رہی تو true
code	integer	کامیاب درخواستوں کے لیے 10000
order	object	آرڈر کی تفصیلات
activation	object | null	ایکٹیویشن کی تفصیلات (اگر پتہ ایکٹیویٹ کیا گیا تھا)
subuser_payout	object | null	ذیلی صارف کے مارک اپ کی تفصیلات (صرف پیرنٹ صارفین کے لیے)

آرڈر آبجیکٹ (Order Object)

فیلڈ	قسم	تفصیل
id	string	فارمیٹ 1H{hash} میں آرڈر ID
cost	number	صارف کی طرف سے ادا کی گئی کل لاگت (TRX)
target_address	string	وہ پتہ جس نے Energy حاصل کی
energy	integer	ڈیلیگیٹ کی گئی Energy کی مقدار
duration	string	ڈیلیگیشن کا دورانیہ (ہمیشہ "1 hour")
tx_hashes	array	ڈیلیگیشن ٹرانزیکشن ہیشز کی فہرست
timestamp	string	آرڈر بننے کا وقت (ISO 8601 فارمیٹ)
rate_sun	number	Energy کی شرح بلحاظ sun فی Energy یونٹ
comments	string | null	اضافی معلومات (مثلاً، ایکٹیویشن کا نوٹس)

ایکٹیویشن آبجیکٹ (Activation Object)

فیلڈ	قسم	تفصیل
cost	number	ایکٹیویشن کی لاگت (TRX)
tx_hash	string	ایکٹیویشن ٹرانزیکشن ہیش

ذیلی صارف پے آؤٹ آبجیکٹ (Subuser Payout Object)

صرف پیرنٹ صارفین

فیلڈ subuser_payout صرف ان پیرنٹ صارفین کے لیے شامل کیا جاتا ہے جو اپنے ذیلی صارفین کے آرڈرز دیکھ رہے ہوں۔ ذیلی صارفین (mock صارفین) کو یہ فیلڈ نظر نہیں آئے گا۔

فیلڈ	قسم	تفصیل
parent_id	integer	پیرنٹ صارف ID
gross_cost	number	ذیلی صارف کی طرف سے ادا کی گئی کل لاگت (TRX)
energy_markup	number	Energy مارک اپ کی رقم (TRX)
activation_markup	number	ایکٹیویشن مارک اپ کی رقم (TRX)
total_markup	number	کل مارک اپ (Energy + ایکٹیویشن)
net_cost	number	لاگت منہا مارک اپ (پیرنٹ کی اصل لاگت)
subuser_rate_sun	number	ذیلی صارف کی طرف سے ادا کی گئی شرح (sun/energy)
parent_rate_sun	number	بغیر مارک اپ کے اصل شرح (sun/energy)

نقص کے جوابات (Error Responses)

لاپتہ آرڈر ID (400)

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

تصدیقی نقص (401)

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

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

رسائی مسترد (403)

کسی ایسے آرڈر کو دیکھنے کی کوشش کرتے وقت جو کسی دوسرے صارف کا ہو:

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

آرڈر نہیں ملا (404)

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

اندرونی سرور کا نقص (500)

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

نقص کے کوڈز کا حوالہ (Error Code Reference)

کوڈ	تفصیل	HTTP اسٹیٹس
10000	کامیابی	200
-1	تصدیق ناکام ہو گئی	401
-2	لاپتہ order_id پیرامیٹر	400
-3	آرڈر نہیں ملا	404
-4	رسائی مسترد کر دی گئی (آپ کا آرڈر نہیں ہے)	403

شرح کی حدود (Rate Limits)

اس اینڈ پوائنٹ پر شرح کی درج ذیل حدود لاگو ہوتی ہیں (فی IP پتہ):

مدت	حد	تفصیل
1 سیکنڈ	50 درخواستیں	زیادہ سے زیادہ 50 درخواستیں فی سیکنڈ

شرح کی حد کے ہیڈرز (Rate Limit Headers)

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

شرح کی حد سے تجاوز (429)

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

رسائی کا کنٹرول (Access Control)

آرڈر کی ملکیت

صارفین صرف اپنے آرڈرز دیکھ سکتے ہیں۔ API ملکیت کی جانچ اس بنیاد پر کرتا ہے:

• Google صارفین: آرڈر سے google_user_id کو صارف کے Google ID سے ملاتا ہے
• Telegram صارفین: آرڈر سے tg_user_id کو صارف کے Telegram ID سے ملاتا ہے

پیرنٹ اور ذیلی صارف کی رسائی

پیرنٹ صارفین اپنے ذیلی صارفین کے بنائے ہوئے آرڈرز دیکھ سکتے ہیں۔ اس صورت میں:

• جواب میں subuser_payout فیلڈ شامل کیا جاتا ہے
• پیرنٹ صارف مارک اپ کی تفصیل اور اپنی اصل لاگت دیکھ سکتا ہے

ذیلی صارف (Mock) کی رسائی

اپنے آرڈرز دیکھنے والے ذیلی صارفین کو نظر آئے گا:

• ان کی اصل لاگت (مارک اپ سمیت) order.cost میں
• ان کی شرح (مارک اپ سمیت) order.rate_sun میں
• فیلڈ subuser_payout شامل نہیں ہے

استعمال کے مواقع (Use Cases)

1. آرڈر کی تکمیل کی تصدیق کریں

/apiv2/order1h کے ساتھ آرڈر دینے کے بعد، اس کی تصدیق کے لیے اس اینڈ پوائنٹ کا استعمال کریں:

• آرڈر کامیابی سے پروسیس ہو گیا تھا
• Energy درست پتے پر ڈیلیگیٹ کی گئی تھی
• درست رقم چارج کی گئی تھی

2. ٹرانزیکشن ہیش حاصل کریں

بلاک چین کی تصدیق کے لیے ڈیلیگیشن ٹرانزیکشن ہیش حاصل کریں:

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. ذیلی صارف کے اخراجات کو ٹریک کریں (پیرنٹ صارفین)

پیرنٹ صارفین اپنے ذیلی صارفین کے آرڈرز اور مارک اپ کی آمدنی کی نگرانی کر سکتے ہیں:

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")

نوٹس

• آرڈرز بننے کے فوری بعد ان کے بارے میں معلومات حاصل کی جا سکتی ہیں
• اگر فراہم کنندہ انہیں واپس نہ کرے تو ٹرانزیکشن ہیشز خالی ہو سکتے ہیں
• فیلڈ rate_sun sun میں فی Energy یونٹ مؤثر شرح دکھاتا ہے
• لاگو ہونے پر ایکٹیویشن لاگت کل cost میں شامل ہوتی ہے
• فیلڈ comments اضافی سیاق و سباق فراہم کرتا ہے (مثلاً، ایکٹیویشن کا نوٹس)
• یہ اینڈ پوائنٹ صرف وہی 1 گھنٹے کے آرڈرز واپس کرتا ہے جو /apiv2/order1h کے ذریعے بنائے گئے ہوں