POST /apiv2/time/infinitystart

پہلے سے Host Mode میں موجود ایڈریس کے لیے انفینٹی (لامحدود) موڈ فعال کریں — energy اس وقت تک ایک سائیکل کے بعد دوسرے سائیکل میں ڈیلیگیٹ ہوتی رہتی ہے جب تک کہ آپ اسے روک نہ دیں۔

اینڈپوائنٹ URL

POST https://netts.io/apiv2/time/infinitystart

تصدیق (Authentication)

درخواست کے باڈی (api_key) یا X-API-KEY ہیڈر میں اپنی API کلید فراہم کریں۔ درخواست کا IP لازماً آپ کی API کلید کے لیے تشکیل شدہ وائٹ لسٹ میں ہونا چاہیے۔

درخواست کا باڈی (Request Body)

{
    "api_key": "your_api_key",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

پیرامیٹرز

پیرامیٹر	قسم	لازمی	تفصیل
api_key	string	ہاں	API کلید (یا X-API-KEY ہیڈر)۔
address	string	ہاں	TRON (TRC-20) ایڈریس، ^T[1-9A-HJ-NP-Za-km-z]{33}$۔ ایڈریس کا پہلے سے Host Mode میں ہونا ضروری ہے (پہلے اسے شامل کریں)۔

طرز عمل (Behaviour)

• ایڈریس کا پہلے سے Host Mode میں موجود ہونا اور غیر فعال (روکا ہوا) ہونا ضروری ہے۔
• آپ کا بیلنس موجودہ قیمت پر کم از کم ایک سائیکل کا احاطہ کرنے کے لیے کافی ہونا چاہیے (فعال کرنے سے پہلے جانچا جاتا ہے)۔
• یہ اینڈپوائنٹ ایڈریس کو فعال کرتا ہے، ایک اوپن انفینٹی آرڈر بناتا ہے، اور Host Mode اس وقت تک ایک کے بعد دوسرے سائیکل میں energy ڈیلیگیٹ کرتا رہتا ہے جب تک کہ آپ /apiv2/time/stop کو کال نہ کریں۔

سائیکلوں کے بل ان کے ڈیلیگیٹ ہونے کے ساتھ ساتھ وصول کیے جاتے ہیں (فی ڈیلیگیشن ایک سائیکل)۔ ایک ایکٹیویشن کی پہلی ڈیلیگیشن کی لاگت 4 TRX ہے؛ اس کے بعد کی ہر ڈیلیگیشن کی لاگت 2 یا 4 TRX ہوتی ہے جس کا انحصار اس بات پر ہے کہ آپ کے پچھلے ٹرانسفر میں درحقیقت کتنی energy استعمال ہوئی (65,000 ≥ → 2 TRX، زیادہ → 4 TRX)۔ 8 TRX کی یومیہ کم از کم حد (مؤثر از 2026-08-29) اور 2 دن کا غیر فعال شٹ ڈاؤن انفینٹی موڈ میں بھی لاگو ہوتا ہے — دیکھیں Host Mode → سائیکلز اور قیمتوں کا تعین۔

Time Status میں ایک انفینٹی ایڈریس cycles_ordered اور cycles_remaining کو null کے طور پر رپورٹ کرتا ہے — کیونکہ الٹی گنتی کے لیے کوئی حد مقرر نہیں ہے۔ null کا مطلب "لامحدود" سمجھیں، نہ کہ "کوئی سائیکل باقی نہیں بچا"۔

امثلہ برائے درخواست (Example Requests)

cURL

curl -X POST https://netts.io/apiv2/time/infinitystart \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/infinitystart",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Infinity mode active, order:", result["data"]["order_id"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/infinitystart', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

جواب (Response)

کامیابی (200 OK)

{
    "code": 0,
    "msg": "Infinity mode activated successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "order_id": 5427,
        "mode": "infinity",
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

جواب کے فیلڈز

فیلڈ	قسم	تفصیل
code	integer	0 = کامیابی، منفی = خرابی
msg	string	انسان کے پڑھنے کے قابل پیغام
data.address	string	وہ ایڈریس جو انفینٹی موڈ میں فعال کیا گیا ہے
data.order_id	integer	اندرونی آرڈر کی شناخت (آئیڈینٹیفائر)
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	ISO ٹائم اسٹیمپ

خرابی کے جوابات (Error Responses)

code	msg	وجہ
-1	API key required in X-API-KEY header or request body	کوئی API کلید فراہم نہیں کی گئی
-1	Invalid API key or IP not in whitelist	تصدیق ناکام ہو گئی
-1	Invalid TRC-20 address format	ایڈریس کی ساخت درست نہیں ہے
-1	Failed to activate host mode	ایڈریس فعال نہیں ہو سکا — دوبارہ کوشش کریں
-1	Database error activating infinity mode	سرور کی جانب عارضی خرابی — دوبارہ کوشش کریں
-1	Internal server error	غیر متوقع خرابی — دوبارہ کوشش کریں یا سپورٹ سے رابطہ کریں
-2	Insufficient balance. Required: X TRX, Available: Y TRX	بیلنس ایک سائیکل کی قیمت سے کم ہے
-4	Address not found. Please add address first	ایڈریس Host Mode میں موجود نہیں ہے
-5	Host mode is already active for this address	ایڈریس پہلے سے چل رہا ہے
-6	There is already an open order for this address	ایک کھلا آرڈر پہلے سے موجود ہے

{ "code": -4, "msg": "Address not found. Please add address first", "data": null }

HTTP اسٹیٹس کوڈز

اینڈپوائنٹ کی خرابیاں HTTP 200 اور منفی code کے ساتھ واپس کی جاتی ہیں — HTTP اسٹیٹس کے بجائے code چیک کریں۔ خرابی والے جواب کی باڈی میں ہمیشہ "data": null شامل ہوتا ہے۔

کچھ خرابیاں درخواست کے اینڈپوائنٹ تک پہنچنے سے پہلے واپس کر دی جاتی ہیں۔ وہ غیر-200 اسٹیٹس اور باڈی کی ایک مختلف ساخت استعمال کرتی ہیں:

HTTP	باڈی	وجہ
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	اکاؤنٹ کا بیلنس بہت کم ہے
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API کلید بلاک ہے — سپورٹ سے رابطہ کریں
422	{"detail": [ … ]}	درخواست کی باڈی کی تصدیق ناکام ہو گئی: کوئی لازمی فیلڈ غائب ہے یا اس کی نوعیت (type) غلط ہے۔ نوٹ کریں کہ اس جواب میں کوئی code فیلڈ نہیں ہے

متعلقہ اینڈپوائنٹس

• POST /apiv2/time/add — پہلے ایڈریس شامل کریں
• POST /apiv2/time/order — اس کے بجائے سائیکلوں کی ایک مقررہ تعداد خریدیں
• POST /apiv2/time/stop — انفینٹی موڈ کو روکیں
• POST /apiv2/time/status — اسٹیٹس چیک کریں

نوٹس

• انفینٹی موڈ اس وقت تک چلتا رہتا ہے جب تک کہ آپ اسے /apiv2/time/stop کے ذریعے روک نہ دیں۔
• کافی بیلنس دستیاب رکھیں — سائیکلوں کی فیس ان کے ڈیلیگیٹ ہونے پر وصول کی جاتی ہے۔
• اس اینڈپوائنٹ کا استعمال ایسے ایڈریس کو دوبارہ شروع کرنے کے لیے کریں جسے پہلے روکا گیا تھا (اس کا غیر فعال ہونا ضروری ہے)۔