POST /apiv2/time/stop

एक TRON पते के लिए Host Mode रोकें: इसके खुले ऑर्डर्स को बंद करें और इसे निष्क्रिय करें। पता Host Mode में पंजीकृत रहता है और इसे बाद में फिर से सक्रिय किया जा सकता है।

एंडपॉइंट URL

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

प्रमाणीकरण

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

अनुरोध बॉडी

{
    "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 में और वर्तमान में सक्रिय होना चाहिए।

व्यवहार

किसी पते को रोकने पर:

• इसके सभी खुले ऑर्डर्स बंद हो जाते हैं।
• Host Mode को निष्क्रिय (status = 0, cycle_set = 0) पर सेट करता है।
• पते के लिए उपयोग किए गए चक्र (cycle) के काउंटर को रीसेट करता है।
• जब तक आप इसे पुन: सक्रिय नहीं करते ( /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));

प्रतिक्रिया

सफलता (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 फ़ील्ड नहीं है

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

रोकना बनाम हटाना

	रोकना	हटाना
Host Mode पंजीकरण	सुरक्षित रहता है	हटा दिया जाता है
खुले ऑर्डर्स	बंद	कोई नहीं होना चाहिए
पुन: सक्रियण	order / infinitystart	दोबारा add करना होगा
कॉलबैक URL	सुरक्षित रहता है	हटा दिया जाता है

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

• POST /apiv2/time/infinitystart — पते को पुन: सक्रिय करें (असीमित)
• POST /apiv2/time/order — चक्रों (cycles) की एक निश्चित संख्या के साथ पुन: सक्रिय करें
• POST /apiv2/time/status — स्थिति की जांच करें
• POST /apiv2/time/delete — पते को पूरी तरह से हटाएं

टिप्पणियाँ

• रोकने पर पता Host Mode में ही रहता है; इसे किसी भी समय पुन: सक्रिय किया जा सकता है।
• शेष ऑर्डर किए गए चक्र आगे नहीं बढ़ाए जाते हैं — रोके जाने पर उपयोग किए गए चक्र का काउंटर रीसेट हो जाता है।