GET /apiv2/order_check

किसी विशिष्ट 1-घंटे के energy ऑर्डर के बारे में विस्तृत जानकारी प्राप्त करें, जिसमें लागत का विवरण, सक्रियण (activation) विवरण और subuser मार्कअप जानकारी शामिल है।

एंडपॉइंट URL

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

अनुरोध हेडर

हेडर	आवश्यक	विवरण
X-API-KEY	हाँ	Netts डैशबोर्ड से आपकी API कुंजी

क्वेरी पैरामीटर

पैरामीटर	प्रकार	आवश्यक	विवरण
order_id	string	हाँ	1H{hash} प्रारूप में ऑर्डर ID (उदा., 1Ha1b2c3d4e5)

उदाहरण अनुरोध

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

प्रतिक्रिया

सफल प्रतिक्रिया (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
}

Subuser Payout के साथ सफल प्रतिक्रिया (200 OK)

Subuser के ऑर्डर देखने वाले मूल (parent) उपयोगकर्ताओं के लिए:

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

प्रतिक्रिया फ़ील्ड

मुख्य प्रतिक्रिया

फ़ील्ड	प्रकार	विवरण
success	boolean	यदि अनुरोध सफल रहा तो true
code	integer	सफल अनुरोधों के लिए 10000
order	object	ऑर्डर विवरण
activation	object | null	सक्रियण विवरण (यदि पता सक्रिय किया गया था)
subuser_payout	object | null	Subuser मार्कअप विवरण (केवल मूल उपयोगकर्ताओं के लिए)

Order ऑब्जेक्ट

फ़ील्ड	प्रकार	विवरण
id	string	1H{hash} प्रारूप में ऑर्डर ID
cost	number	उपयोगकर्ता द्वारा भुगतान की गई कुल लागत (TRX)
target_address	string	वह पता जिसने energy प्राप्त की
energy	integer	प्रत्यायोजित (delegated) energy राशि
duration	string	प्रत्यायोजन अवधि (हमेशा "1 hour")
tx_hashes	array	प्रत्यायोजन लेनदेन हैश की सूची
timestamp	string	ऑर्डर निर्माण समय (ISO 8601 प्रारूप)
rate_sun	number	प्रति energy इकाई sun में energy दर
comments	string | null	अतिरिक्त जानकारी (उदा., सक्रियण सूचना)

Activation ऑब्जेक्ट

फ़ील्ड	प्रकार	विवरण
cost	number	सक्रियण लागत (TRX)
tx_hash	string	सक्रियण लेनदेन हैश

Subuser Payout ऑब्जेक्ट

केवल मूल उपयोगकर्ताओं के लिए

subuser_payout फ़ील्ड केवल अपने subusers के ऑर्डर देखने वाले मूल उपयोगकर्ताओं के लिए शामिल किया गया है। Subusers (mock उपयोगकर्ता) इस फ़ील्ड को नहीं देख पाएंगे।

फ़ील्ड	प्रकार	विवरण
parent_id	integer	मूल उपयोगकर्ता ID
gross_cost	number	Subuser द्वारा भुगतान की गई कुल लागत (TRX)
energy_markup	number	Energy मार्कअप राशि (TRX)
activation_markup	number	सक्रियण मार्कअप राशि (TRX)
total_markup	number	कुल मार्कअप (energy + सक्रियण)
net_cost	number	लागत घटाव मार्कअप (मूल उपयोगकर्ता की वास्तविक लागत)
subuser_rate_sun	number	Subuser द्वारा भुगतान की गई दर (sun/energy)
parent_rate_sun	number	मार्कअप के बिना वास्तविक दर (sun/energy)

त्रुटि प्रतिक्रियाएँ

अनुपलब्ध ऑर्डर 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"
}

त्रुटि कोड संदर्भ

कोड	विवरण	HTTP स्थिति
10000	सफलता	200
-1	प्रमाणीकरण विफल	401
-2	अनुपलब्ध order_id पैरामीटर	400
-3	ऑर्डर नहीं मिला	404
-4	पहुँच अस्वीकृत (आपका ऑर्डर नहीं है)	403

दर सीमाएँ

इस एंडपॉइंट पर निम्नलिखित दर सीमाएँ लागू होती हैं (प्रति IP पता):

अवधि	सीमा	विवरण
1 सेकंड	50 अनुरोध	प्रति सेकंड अधिकतम 50 अनुरोध

दर सीमा हेडर

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

पहुँच नियंत्रण

ऑर्डर का स्वामित्व

उपयोगकर्ता केवल अपने ऑर्डर ही देख सकते हैं। API निम्नलिखित के आधार पर स्वामित्व की जाँच करता है:

• Google उपयोगकर्ता: ऑर्डर से google_user_id का उपयोगकर्ता के Google ID से मिलान करता है
• Telegram उपयोगकर्ता: ऑर्डर से tg_user_id का उपयोगकर्ता के Telegram ID से मिलान करता है

मूल-Subuser पहुँच

मूल उपयोगकर्ता अपने subusers द्वारा बनाए गए ऑर्डर देख सकते हैं। इस स्थिति में:

• प्रतिक्रिया में subuser_payout फ़ील्ड शामिल होता है
• मूल उपयोगकर्ता मार्कअप विवरण और अपनी वास्तविक लागत देख सकता है

Subuser (Mock) पहुँच

अपने स्वयं के ऑर्डर देखने वाले Subusers देखेंगे:

• order.cost में उनकी वास्तविक लागत (मार्कअप सहित)
• order.rate_sun में उनकी दर (मार्कअप सहित)
• subuser_payout फ़ील्ड शामिल नहीं है

उपयोग के मामले

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. Subuser लागतों को ट्रैक करें (मूल उपयोगकर्ता)

मूल उपयोगकर्ता अपने subusers के ऑर्डर और मार्कअप आय की निगरानी कर सकते हैं:

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 फ़ील्ड अतिरिक्त संदर्भ प्रदान करता है (उदा., सक्रियण सूचना)
• यह एंडपॉइंट केवल /apiv2/order1h के माध्यम से बनाए गए 1-घंटे के ऑर्डर ही लौटाता है