POST /apiv2/time/stop

کسی TRON ایڈریس کے لیے Host Mode روکیں: اس کے کھلے آرڈرز بند کریں اور اسے غیر فعال کریں۔ ایڈریس Host Mode میں رجسٹرڈ رہتا ہے اور اسے بعد میں دوبارہ فعال کیا جا سکتا ہے۔

اینڈ پوائنٹ URL

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

تصدیق (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 غیر فعال پر سیٹ ہو جاتا ہے (status = 0، cycle_set = 0)۔
• ایڈریس کے لیے استعمال شدہ سائیکلز کا کاؤنٹر ری سیٹ ہو جاتا ہے۔
• جب تک آپ اسے دوبارہ فعال نہیں کرتے (/apiv2/time/order یا /apiv2/time/infinitystart کے ساتھ)، کوئی نئی Energy ڈیلیگیٹ نہیں کی جاتی۔

ایڈریس خود Host Mode میں رہتا ہے؛ اسے مکمل طور پر ہٹانے کے لیے /apiv2/time/delete استعمال کریں۔

مثال کی درخواستیں

cURL

curl -X POST https://netts.io/apiv2/time/stop \
  -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/stop",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Stopped. Orders closed:", result["data"]["orders_closed"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/stop', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Stopped. Orders closed:', result.data.orders_closed);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

جواب (Response)

کامیابی (200 OK)

{
    "code": 0,
    "msg": "Host mode stopped successfully, closed 1 order(s)",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "orders_closed": 1,
        "status": "inactive",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

جواب کے فیلڈز

فیلڈ	قسم	تفصیل
code	integer	0 = کامیابی، منفی = خرابی
msg	string	انسان کے پڑھنے کے قابل پیغام
data.address	string	وہ ایڈریس جسے روکا گیا تھا
data.orders_closed	integer	بند کیے گئے کھلے آرڈرز کی تعداد
data.status	string	"inactive"
data.timestamp	string	ISO ٹائم اسٹیمپ

خرابی کے جوابات

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	Database error stopping host mode	عارضی سرور کی خرابی — دوبارہ کوشش کریں
-1	Internal server error	غیر متوقع خرابی — دوبارہ کوشش کریں یا سپورٹ سے رابطہ کریں
-4	Address not found	ایڈریس آپ کے اکاؤنٹ کے تحت Host Mode میں نہیں ہے
-7	Host mode is already inactive	ایڈریس پہلے سے ہی روکا ہوا ہے

{ "code": -7, "msg": "Host mode is already inactive", "data": null }

HTTP اسٹیٹس کوڈز

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

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

HTTP	باڈی	وجہ
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API کلید بلاک ہے — سپورٹ سے رابطہ کریں
422	{"detail": [ … ]}	درخواست کی باڈی توثیق میں ناکام رہی: کوئی مطلوبہ فیلڈ غائب ہے یا اس کی غلط قسم ہے۔ نوٹ کریں کہ اس جواب میں کوئی code فیلڈ نہیں ہے

کسی ایڈریس کو روکنا آپ کے اکاؤنٹ کے بیلنس سے قطع نظر ہمیشہ دستیاب ہوتا ہے۔

روکنا بمقابلہ حذف کرنا (Stop vs Delete)

	Stop	Delete
Host Mode رجسٹریشن	برقرار رہتی ہے	ہٹا دی جاتی ہے
کھلے آرڈرز	بند کر دیے جاتے ہیں	کوئی نہیں ہونا چاہیے
دوبارہ فعال کرنا	order / infinitystart	دوبارہ add کرنا ہوگا
کال بیک URL	برقرار رہتا ہے	ہٹا دیا جاتا ہے

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

• POST /apiv2/time/infinitystart — ایڈریس کو دوبارہ فعال کریں (لامحدود)
• POST /apiv2/time/order — سائیکلز کی مقررہ تعداد کے ساتھ دوبارہ فعال کریں
• POST /apiv2/time/status — اسٹیٹس چیک کریں
• POST /apiv2/time/delete — ایڈریس کو مکمل طور پر ہٹائیں

نوٹس

• روکنے سے ایڈریس Host Mode میں رہتا ہے؛ اسے کسی بھی وقت دوبارہ فعال کیا جا سکتا ہے۔
• باقی ماندہ آرڈر شدہ سائیکلز آگے منتقل نہیں کیے جاتے — روکنے پر استعمال شدہ سائیکلز کا کاؤنٹر ری سیٹ ہو جاتا ہے۔