POST /apiv2/time/delete

کسی TRON ایڈریس کو Host Mode سے مکمل طور پر ہٹائیں۔ ڈیفالٹ کے طور پر، ایڈریس کا پہلے سے غیر فعال (روکا ہوا) ہونا اور کوئی کھلے آرڈرز نہ ہونا لازمی ہے؛ اسے ایک ہی کال میں روکنے اور حذف کرنے کے لیے "stop": true پاس کریں۔

اینڈپوائنٹ URL

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

تصدیق (Authentication)

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

درخواست کی باڈی

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

پیرامیٹرز

پیرامیٹر	قسم	درکار ہے	تفصیل
api_key	string	ہاں	API کی (یا X-API-KEY ہیڈر)۔
address	string	ہاں	TRON (TRC-20) ایڈریس، ^T[1-9A-HJ-NP-Za-km-z]{33}$۔ آپ کے اکاؤنٹ سے تعلق رکھنا لازمی ہے۔
stop	boolean	نہیں	true — کال مسترد کرنے کے بجائے حذف کرنے سے پہلے ایڈریس پر Host Mode روک دیں۔ یہ /apiv2/time/stop پر علیحدہ درخواست کی بچت کرتا ہے۔ ڈیفالٹ false ہے۔

طرز عمل

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

stop

"stop": true کے ساتھ ایک فعال ایڈریس کو ایک ہی کال میں روک دیا جاتا ہے اور حذف کر دیا جاتا ہے — وہی نتیجہ جو /apiv2/time/stop اور پھر /apiv2/time/delete کو کال کرنے سے ملتا ہے، اور بالکل وہی اقدامات: ایڈریس کے تمام کھلے آرڈرز بند کر دیے جاتے ہیں، Host Mode بند کر دیا جاتا ہے، سائیکل کاؤنٹر ری سیٹ ہو جاتا ہے، اور رکنے کا عمل آپ کی ایکشن ہسٹری میں درج ہو جاتا ہے۔ صرف اس کے بعد ایڈریس کو حذف کیا جاتا ہے۔

دونوں مراحل ایک ٹرانزیکشن میں چلتے ہیں: یا تو ایڈریس روک دیا جاتا ہے اور حذف کر دیا جاتا ہے، یا کچھ بھی تبدیل نہیں ہوتا۔ ایسی کوئی حالت نہیں ہے جہاں ایڈریس رک جائے لیکن پھر بھی رجسٹرڈ رہے۔

یہ فلیگ صرف اسی وقت اہمیت رکھتا ہے جب روکنے کے لیے کچھ ہو۔ ایسے ایڈریس پر جو پہلے سے غیر فعال ہو اور اس کے پاس کوئی کھلے آرڈرز نہ ہوں، یہ کچھ بھی تبدیل نہیں کرتا — کال بالکل اسی طرح برتاؤ کرتی ہے جیسے اس کے بغیر، اور جواب ایک سادہ ڈیلیٹ کا جواب ہوتا ہے۔

بلنگ پر کوئی اثر نہیں پڑتا: روکنے سے کوئی رقم واپس نہیں ہوتی اور حذف کرنے سے کوئی چارج نہیں لگتا۔ پہلے سے تفویض کردہ سائیکلز چارج شدہ ہی رہتے ہیں، اور ایڈریس کو فی الوقت تفویض کردہ Energy اس کے معمول کے شیڈول کے مطابق واپس حاصل کر لی جاتی ہے۔ ملاحظہ کریں Host Mode → Cycles and Pricing۔

امثلہ برائے درخواستیں

cURL

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

ایک ہی کال میں روکیں اور حذف کریں:

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

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/delete",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        # "stop": True,  # optional: stop Host Mode on the address instead of failing
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Deleted:", result["data"]["address"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/delete', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    // stop: true, // optional: stop Host Mode on the address instead of failing
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Deleted:', result.data.address);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

جواب

کامیابی (200 OK)

{
    "code": 0,
    "msg": "Address deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

کامیابی جب ایڈریس پہلے روکا گیا تھا ("stop": true)

{
    "code": 0,
    "msg": "Address stopped and deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "stopped": true,
        "orders_closed": 1,
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

جواب کے فیلڈز

فیلڈ	قسم	تفصیل
code	integer	0 = کامیابی، منفی = خرابی
msg	string	انسانی فہم کے مطابق پیغام۔ Address stopped and deleted from Host Mode successfully جب ایڈریس کو کال کے ایک حصے کے طور پر روکا گیا تھا
data.address	string	وہ ایڈریس جسے ہٹایا گیا تھا
data.stopped	boolean	صرف تب موجود ہوتا ہے جب Host Mode کو اس کال کے حصے کے طور پر روکا گیا ہو۔ سادہ ڈیلیٹ پر غائب ہوتا ہے
data.orders_closed	integer	اس روکنے کے عمل سے بند ہونے والے کھلے آرڈرز کی تعداد۔ صرف stopped کے ساتھ موجود ہوتا ہے
data.timestamp	string	ISO ٹائم اسٹیمپ

غلطی کے جوابات

تمام غلطیاں code = -1 استعمال کرتی ہیں:

msg	وجہ
API key required in X-API-KEY header or request body	کوئی API کی فراہم نہیں کی گئی
Invalid API key or IP not in whitelist	تصدیق ناکام ہو گئی
Invalid TRC-20 address format	غلط ایڈریس فارمیٹ
Address not found or does not belong to you	ایڈریس آپ کے اکاؤنٹ کے تحت رجسٹرڈ نہیں ہے
Cannot delete an active address. Stop Host mode first	ایڈریس فعال ہے اور stop سیٹ نہیں کیا گیا تھا — پہلے /apiv2/time/stop کو کال کریں، یا "stop": true کے ساتھ دوبارہ کوشش کریں
Cannot delete address with active orders	ایڈریس کے پاس ابھی بھی کھلے آرڈرز ہیں اور stop سیٹ نہیں کیا گیا تھا — "stop": true کے ساتھ دوبارہ کوشش کریں
Failed to delete address	ایڈریس کو ہٹایا نہیں جا سکا — دوبارہ کوشش کریں
Database error deleting address	سرور کی جانب سے عارضی خرابی — دوبارہ کوشش کریں
Internal server error	غیر متوقع خرابی — دوبارہ کوشش کریں یا سپورٹ سے رابطہ کریں

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "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 فیلڈ موجود نہیں ہے

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

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

• POST /apiv2/time/stop — حذف کرنے سے پہلے ایڈریس کو روکیں
• POST /apiv2/time/status — اسٹیٹس اور کھلے آرڈرز چیک کریں
• POST /apiv2/time/add — بعد میں ایڈریس کو دوبارہ شامل کریں

نوٹس

• حذف کرنے سے ایڈریس کا کال بیک URL بھی ہٹ جاتا ہے۔
• ڈیلیٹ کی اجازت صرف غیر فعال ایڈریسز کے لیے ہے جن کے کوئی کھلے آرڈرز نہ ہوں — پہلے اسے /apiv2/time/stop کے ذریعے روکیں، یا اپنے لیے رکوانے کی خاطر یہاں "stop": true پاس کریں۔
• وہی ایڈریس کسی بھی وقت دوبارہ شامل کیا جا سکتا ہے۔