POST /apiv2/time/delete

Host Mode से TRON एड्रेस को पूरी तरह से हटाएं। डिफ़ॉल्ट रूप से एड्रेस पहले से निष्क्रिय (stopped) होना चाहिए और उस पर कोई ओपन ऑर्डर नहीं होना चाहिए; इसे एक ही कॉल में रोकने और हटाने के लिए "stop": true पास करें।

एंडपॉइंट URL

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

प्रमाणीकरण (Authentication)

अनुरोध बॉडी (api_key) में या X-API-KEY हेडर में अपनी API कुंजी प्रदान करें। अनुरोध IP आपकी API कुंजी के लिए कॉन्फ़िगर की गई श्वेतसूची (whitelist) में होना चाहिए।

अनुरोध बॉडी (Request Body)

{
    "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।

व्यवहार (Behaviour)

• बिना stop के, एड्रेस निष्क्रिय होना चाहिए — यदि यह सक्रिय है तो पहले इसे /apiv2/time/stop से रोकें — और इस पर कोई ओपन ऑर्डर नहीं होना चाहिए। अन्यथा नीचे दी गई त्रुटियों के साथ कॉल को अस्वीकार कर दिया जाता है और कुछ भी नहीं बदला जाता है।
• सफलता पर, एड्रेस को Host Mode से हटा दिया जाता है और उसका पंजीकृत कॉलबैक URL (यदि कोई हो) हटा दिया जाता है।
• वही एड्रेस बाद में /apiv2/time/add के साथ फिर से जोड़ा जा सकता है।

stop

"stop": true के साथ एक सक्रिय एड्रेस को एक ही कॉल में रोक दिया जाता है और हटा दिया जाता है — वही परिणाम जो /apiv2/time/stop और फिर /apiv2/time/delete को कॉल करने पर मिलता है, और बिल्कुल वही क्रियाएं: एड्रेस के लिए सभी ओपन ऑर्डर बंद कर दिए जाते हैं, Host Mode बंद कर दिया जाता है, चक्र काउंटर रीसेट हो जाता है, और स्टॉप को आपके एक्शन इतिहास में दर्ज किया जाता है। उसके बाद ही एड्रेस हटाया जाता है।

दोनों चरण एक लेनदेन (transaction) में चलते हैं: या तो एड्रेस को रोककर हटा दिया जाता है, या कुछ भी नहीं बदलता है। ऐसी कोई स्थिति नहीं होती जहां एड्रेस बंद हो जाए लेकिन फिर भी पंजीकृत रहे।

यह फ़्लैग केवल तभी मायने रखता है जब रोकने के लिए कुछ हो। ऐसे एड्रेस पर जो पहले से ही निष्क्रिय है और कोई ओपन ऑर्डर नहीं है, यह कुछ भी नहीं बदलता है — कॉल बिल्कुल इसके बिना व्यवहार करती है, और प्रतिक्रिया सादा डिलीट प्रतिक्रिया होती है।

बिलिंग अप्रभावित रहती है: रोकने से कुछ भी वापस (refund) नहीं होता है और हटाने से कोई शुल्क नहीं लगता है। पहले से प्रत्यायोजित चक्र शुल्कित रहते हैं, और एड्रेस को वर्तमान में प्रत्यायोजित 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));

प्रतिक्रिया (Response)

सफलता (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 के साथ लौटाई जाती हैं — code की जांच करें, HTTP स्थिति की नहीं। त्रुटि बॉडी में हमेशा "data": null शामिल होता है।

कुछ त्रुटियां अनुरोध के एंडपॉइंट तक पहुंचने से पहले लौटाई जाती हैं। वे गैर-200 स्थिति और एक अलग बॉडी संरचना का उपयोग करती हैं:

HTTP	बॉडी	कारण
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API कुंजी अवरोधित (blocked) है — समर्थन से संपर्क करें
422	{"detail": [ … ]}	अनुरोध बॉडी सत्यापन विफल रहा: एक आवश्यक फ़ील्ड अनुपलब्ध है या गलत प्रकार की है। ध्यान दें कि इस प्रतिक्रिया में कोई code फ़ील्ड नहीं है

आपके खाते के शेष (balance) की परवाह किए बिना एड्रेस को हटाना हमेशा उपलब्ध है।

संबंधित एंडपॉइंट

• POST /apiv2/time/stop — हटाने से पहले एड्रेस को रोकें
• POST /apiv2/time/status — स्थिति और ओपन ऑर्डरों की जांच करें
• POST /apiv2/time/add — बाद में एड्रेस को फिर से जोड़ें

नोट्स

• हटाने से एड्रेस का कॉलबैक URL भी हट जाता है।
• हटाना केवल बिना किसी ओपन ऑर्डर वाले निष्क्रिय एड्रेस के लिए अनुमत है — इसे पहले /apiv2/time/stop से रोकें, या इसे अपने लिए रोकने के लिए यहाँ "stop": true पास करें।
• वही एड्रेस किसी भी समय फिर से जोड़ा जा सकता है।