Activator — ایڈریس کی ایکٹیویشن

ایک ایسے TRON ایڈریس کو فعال کریں جو آن چین کبھی استعمال نہیں ہوا ہو۔ بالکل نئے ایڈریس کا کوئی اکاؤنٹ ریکارڈ نہیں ہوتا، لہٰذا وہ ایکٹیویٹ ہونے تک ڈیلیگیٹڈ Energy یا Bandwidth حاصل نہیں کر سکتا۔ یہ اینڈ پوائنٹ آپ کے لیے اکاؤنٹ بناتا ہے اور ایکٹیویشن ٹرانزیکشن ہیش (hash) واپس کرتا ہے۔

ایکٹیویشن فی ایڈریس ایک بار کا عمل ہے۔ اگر ایڈریس پہلے سے ایکٹیو ہے، تو اینڈ پوائنٹ آپ کو اس کی اطلاع دیتا ہے اور کوئی چارج نہیں لیتا۔

Endpoint کی بنیادی URL

https://netts.io/apiv2/activator

پرانا راستہ https://netts.io/apiv2/activation اسی سروس کے ذریعے چلایا جاتا ہے اور بالکل اسی طرح کام کرتا ہے۔ نئے انضمام (integrations) کے لیے /apiv2/activator استعمال کیا جانا چاہیے۔

Request ہیڈرز

ہیڈر	لازمی	تفصیل
Content-Type	جی ہاں	application/json
X-API-KEY	جی ہاں	Netts ڈیش بورڈ سے آپ کی API کلید
X-Real-IP	جی ہاں	آپ کی وائٹ لسٹ سے IP ایڈریس

آپ کا user_id، API کلید سے اخذ کیا جاتا ہے — آپ کو اسے بھیجنے کی ضرورت نہیں ہوتی۔

---

ایکٹیویٹ کریں — POST /apiv2/activator

Request باڈی

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

فیلڈ	قسم	لازمی	تفصیل
targetAddress	سٹرنگ	جی ہاں	ایکٹیویٹ کرنے کے لیے TRON ایڈریس۔ لازمی طور پر ^T[A-Za-z0-9]{33}$ سے مطابقت رکھتا ہو (34 حروف، T سے شروع ہوتا ہے)۔

Response — ایکٹیویٹ ہو گیا (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	سٹرنگ	ایکٹیویشن آرڈر نمبر، ہمیشہ A + ہندسے۔ مفاہمت (reconciliation) کے لیے اسے استعمال کریں۔
targetAddress	سٹرنگ	وہ ایڈریس جو ایکٹیویٹ کیا گیا
activation_cost	فلوٹ	آپ کے بیلنس سے کاٹی گئی رقم، TRX میں
user_balance_before	فلوٹ	کٹوتی سے پہلے کا بیلنس
user_balance_after	فلوٹ	کٹوتی کے بعد کا بیلنس
hash	سٹرنگ	ایکٹیویشن ٹرانزیکشن ہیش۔ کسی بھی TRON ایکسپلورر پر اس کی تصدیق کریں۔

Response — پہلے سے فعال ہے (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 آپ کے ذمے ہے۔ اینڈ پوائنٹ میں کوئی idempotency کی (key) نہیں ہے۔ پہلے سے فعال ایڈریس کے لیے درخواست دہرانا محفوظ اور مفت ہے (2001)، لیکن ایک ہی بالکل نئے ایڈریس کے لیے دو بیک وقت کی جانے والی درخواستیں دونوں آگے بڑھ سکتی ہیں۔ اپنی طرف سے فی ایڈریس ایکٹیویشن کو ترتیب وار (serialise) بنائیں۔
• orderId فارمیٹ A + ہندسے ہے اور تمام ایکٹیویشنز میں منفرد ہوتا ہے۔
• آج ایکٹیویشن کے لیے کوئی ویب ہک نہیں بھیجا جاتا — رسپانس اور hash ہی اس کی تصدیق ہیں۔ ویب ہکس فی الحال صرف تصدیق شدہ Energy ڈیلیگیشنز کا احاطہ کرتے ہیں، دیکھیں Webhooks۔