Activator — एड्रेस सक्रियकरण

उस TRON एड्रेस को सक्रिय करें जिसका कभी ऑन-चेन उपयोग नहीं किया गया है। बिल्कुल नए एड्रेस का कोई अकाउंट रिकॉर्ड नहीं होता है, इसलिए यह सक्रिय होने तक डेलिगेट की गई Energy या Bandwidth प्राप्त नहीं कर सकता है। यह एंडपॉइंट आपके लिए अकाउंट बनाता है और सक्रियकरण ट्रांसफ़ैक्शन हैश लौटाता है।

सक्रियकरण प्रति एड्रेस एक बार होने वाला ऑपरेशन है। यदि एड्रेस पहले से ही सक्रिय है, तो एंडपॉइंट आपको इसकी जानकारी देता है और कोई शुल्क नहीं लेता।

एंडपॉइंट बेस URL

https://netts.io/apiv2/activator

पुराना पाथ https://netts.io/apiv2/activation भी उसी सर्विस द्वारा संचालित होता है और बिल्कुल समान व्यवहार करता है। नए इंटीग्रेशन के लिए /apiv2/activator का उपयोग किया जाना चाहिए।

रिक्वेस्ट हेडर

हेडर	आवश्यक	विवरण
Content-Type	हाँ	application/json
X-API-KEY	हाँ	NETTS डैशबोर्ड से आपकी API कुंजी
X-Real-IP	हाँ	आपकी श्वेतसूची (व्हाइटलिस्ट) से IP एड्रेस

आपकी user_id API कुंजी से प्राप्त की जाती है — आपको इसे कभी पास करने की आवश्यकता नहीं होती।

---

सक्रिय करें — POST /apiv2/activator

रिक्वेस्ट बॉडी

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

फ़ील्ड	प्रकार	आवश्यक	विवरण
targetAddress	string	हाँ	सक्रिय करने के लिए TRON एड्रेस। ^T[A-Za-z0-9]{33}$ से मेल खाना चाहिए (34 वर्ण, T से शुरू)।

रिस्पॉन्स — सक्रिय हो गया (200, कोड 10000)

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX deducted",
        "data": {
            "orderId": "A123456",
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "activation_cost": 1.1,
            "user_balance_before": 500.00,
            "user_balance_after": 498.90,
            "hash": "0000000000000000000000000000000000000000000000000000000000000000"
        }
    }
}

फ़ील्ड	प्रकार	विवरण
orderId	string	सक्रियकरण ऑर्डर संख्या, हमेशा A + अंक। समाधान (रिकॉन्सिलेशन) के लिए इसका उपयोग करें।
targetAddress	string	वह एड्रेस जो सक्रिय किया गया था
activation_cost	float	आपके बैलेंस से काटी गई राशि, TRX में
user_balance_before	float	कटौती से पहले का बैलेंस
user_balance_after	float	कटौती के बाद का बैलेंस
hash	string	सक्रियकरण ट्रांज़ैक्शन हैश। किसी भी TRON एक्सप्लोरर पर इसे सत्यापित करें।

रिस्पॉन्स — पहले से सक्रिय है (200, कोड 2001)

तब लौटाया जाता है जब एड्रेस पहले से ऑन-चेन मौजूद होता है। कोई शुल्क नहीं लिया जाता।

{
    "detail": {
        "code": 2001,
        "msg": "Address is already activated",
        "data": {
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "status": "already_activated",
            "user_balance": 500.00,
            "activation_cost": 0,
            "activation_required": false
        }
    }
}

शुल्क लगा है यह मानने से पहले code की जाँच करें: 10000 का अर्थ है आपने भुगतान किया, 2001 का अर्थ है आपने भुगतान नहीं किया।

उदाहरण

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

---

मूल्य

मद	राशि
सक्रियकरण	1.1 TRX
एड्रेस पहले से सक्रिय है	0

राशि निश्चित है और यह एड्रेस या नेटवर्क स्थितियों पर निर्भर नहीं करती है। यह सक्रियकरण सफल होने के समय आपके NETTS बैलेंस से काटी जाती है — पहले कभी नहीं। विफल सक्रियकरण पर कोई शुल्क नहीं लगता है।

आपके बैलेंस में लागत को कवर करने के लिए पर्याप्त राशि होनी चाहिए, अन्यथा अनुरोध को 403 (1004) के साथ अस्वीकार कर दिया जाता है और कोई ऑर्डर नहीं बनाया जाता है।

---

आपको इसकी आवश्यकता कब होती है

• एक नए एड्रेस के लिए Energy या Bandwidth किराए पर लेने से पहले। गैर-मौजूद अकाउंट में डेलिगेशन विफल हो जाता है। पहले सक्रिय करें, फिर ऑर्डर करें।
• आपके द्वारा स्वयं जनरेट किए गए एड्रेस पर पहले इनकमिंग ट्रांसफर से पहले।

आपको ऐसे किसी एड्रेस के लिए इस एंडपॉइंट को कॉल करने की आवश्यकता नहीं है जिसने कभी TRX या कोई टोकन प्राप्त किया हो — यह पहले से ही सक्रिय है, और कॉल केवल 2001 लौटाएगी।

नए एड्रेस के लिए Energy ऑर्डर करना

1-घंटे वाला Energy एंडपॉइंट ऑर्डर के हिस्से के रूप में एक गैर-सक्रिय प्राप्तकर्ता को अपने आप सक्रिय कर देता है, और सक्रियकरण लागत उस ऑर्डर में जोड़ दी जाती है। जब आप किसी भी रेंटल से पहले एड्रेस को सक्रिय करना चाहते हैं, तो स्पष्ट रूप से एक्टिवेटर को कॉल करें — उदाहरण के लिए पहले Bandwidth टॉप अप करने के लिए, जिसके लिए एक सक्रिय अकाउंट की आवश्यकता होती है।

---

समय (टाइमिंग)

सक्रियकरण एक वास्तविक ऑन-चेन ट्रांज़ैक्शन है। एंडपॉइंट इसके प्रसारित होने और सक्रियकरण रिकॉर्ड लिखे जाने के बाद, आमतौर पर कुछ सेकंड के भीतर वापस आ जाता है।

ट्रांज़ैक्शन के एक ब्लॉक में शामिल होने के बाद ही एड्रेस उपयोग करने योग्य बनता है — रिस्पॉन्स के लगभग ~3 सेकंड बाद तक, क्योंकि यह TRON ब्लॉक अंतराल है। यदि आपका अगला कदम एड्रेस के सक्रिय होने पर निर्भर करता है (उदाहरण के लिए Bandwidth ऑर्डर करना), तो तुरंत कॉल करने के बजाय लौटाए गए hash द्वारा ऑन-चेन स्थिति की पुष्टि करें।

---

एरर कोड संदर्भ

कोड	विवरण	HTTP स्थिति
10000	एड्रेस सक्रिय हो गया, बैलेंस काट लिया गया	200
2001	एड्रेस पहले से सक्रिय है, कोई शुल्क नहीं लिया गया	200
-1	अमान्य API कुंजी / IP श्वेतसूची (व्हाइटलिस्ट) में नहीं है	401
1004	अपर्याप्त धनराशि — संदेश बताता है कि क्या आवश्यक है और आपके पास क्या उपलब्ध है	403
-	अमान्य targetAddress प्रारूप (34 वर्ण होने चाहिए, T से शुरू होना चाहिए)	422
5003	सक्रियकरण विफल या सेवा अस्थायी रूप से अनुपलब्ध — बाद में पुनः प्रयास करें	503
5000	आंतरिक सर्वर त्रुटि (इंटरनल सर्वर एरर)	500

503 का अर्थ है कि कोई शुल्क नहीं लिया गया और कोई एड्रेस सक्रिय नहीं हुआ: अनुरोध को सुरक्षित रूप से पुनः प्रयास किया जा सकता है।

दर सीमाएं (रेट लिमिट्स)

प्रति स्रोत IP सीमित:

अवधि	सीमा
1 सेकंड	5 अनुरोध
1 मिनट	60 अनुरोध

दर सीमा पार हो गई (429)

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

नोट्स

• आइडम्पोटेंसी (Idempotency) आपके ऊपर निर्भर है। एंडपॉइंट में कोई आइडम्पोटेंसी कुंजी नहीं है। पहले से सक्रिय एड्रेस के लिए अनुरोध दोहराना सुरक्षित और मुफ़्त है (2001), लेकिन एक ही बिल्कुल नए एड्रेस के लिए दो समवर्ती अनुरोध दोनों प्रोसेस हो सकते हैं। अपनी ओर से प्रति एड्रेस सक्रियकरण को क्रमबद्ध (सीरियलाइज़) करें।
• orderId प्रारूप A + अंक है और यह सभी सक्रियकरणों में अद्वितीय होता है।
• आज सक्रियकरण के लिए कोई वेबहुक नहीं भेजा जाता है — रिस्पॉन्स और hash ही इसकी पुष्टि हैं। वेबहुक वर्तमान में केवल पुष्टीकृत Energy डेलिगेशन को कवर करते हैं, देखें Webhooks।