POST /apiv2/time/stop

Bir TRON adresi için Host Mode'u durdurun: açık siparişlerini kapatın ve devre dışı bırakın. Adres Host Mode içinde kayıtlı kalır ve daha sonra yeniden etkinleştirilebilir.

Uç Nokta URL'si

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

Kimlik Doğrulama

API anahtarınızı istek gövdesinde (api_key) veya X-API-KEY üstbilgisinde sağlayın. İstek IP adresi, API anahtarınız için yapılandırılmış beyaz listede olmalıdır.

İstek Gövdesi

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

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarı (veya X-API-KEY üstbilgisi).
address	string	Evet	TRON (TRC-20) adresi, ^T[1-9A-HJ-NP-Za-km-z]{33}$. Host Mode içinde ve şu anda aktif olmalıdır.

Davranış

Bir adresi durdurmak:

• Tüm açık siparişlerini kapatır.
• Host Mode durumunu etkin değil (status = 0, cycle_set = 0) olarak ayarlar.
• Adres için kullanılan döngü sayacını sıfırlar.
• Siz yeniden etkinleştirene kadar (/apiv2/time/order veya /apiv2/time/infinitystart ile) yeni Energy delege edilmez.

Adresin kendisi Host Mode içinde kalır; tamamen kaldırmak için /apiv2/time/delete kullanın.

Örnek İstekler

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));

Yanıt

Başarılı (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"
    }
}

Yanıt Alanları

Alan	Tür	Açıklama
code	integer	0 = başarılı, negatif = hata
msg	string	Okunabilir mesaj
data.address	string	Durdurulan adres
data.orders_closed	integer	Kapatılan açık sipariş sayısı
data.status	string	"inactive"
data.timestamp	string	ISO zaman damgası

Hata Yanıtları

code	msg	Neden
-1	API key required in X-API-KEY header or request body	API anahtarı sağlanmadı
-1	Invalid API key or IP not in whitelist	Kimlik doğrulama başarısız oldu
-1	Invalid TRC-20 address format	Geçersiz adres biçimi
-1	Database error stopping host mode	Geçici sunucu tarafı hatası — tekrar deneyin
-1	Internal server error	Beklenmeyen hata — tekrar deneyin veya destek ile iletişime geçin
-4	Address not found	Adres, hesabınız altında Host Mode içinde bulunmuyor
-7	Host mode is already inactive	Adres zaten durdurulmuş

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

HTTP durum kodları

Uç nokta hataları HTTP 200 ve negatif bir code ile döndürülür — HTTP durumunu değil, code değerini kontrol edin. Hata gövdeleri her zaman "data": null içerir.

Bazı hatalar, istek uç noktaya ulaşmadan önce döndürülür. Bunlar 200 dışı bir durum ve farklı bir gövde yapısı kullanır:

HTTP	Gövde	Neden
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API anahtarı engellendi — destek ile iletişime geçin
422	{"detail": [ … ]}	İstek gövdesi doğrulamadan geçemedi: zorunlu bir alan eksik veya yanlış türde. Bu yanıtta code alanı bulunmadığına dikkat edin

Bir adresi durdurma işlemi, hesap bakiyenizden bağımsız olarak her zaman kullanılabilir.

Durdurma (Stop) ve Silme (Delete) Karşılaştırması

	Durdur	Sil
Host Mode kaydı	Korunur	Kaldırılır
Açık siparişler	Kapatılır	Hiç olmamalıdır
Yeniden etkinleştirme	order / infinitystart	Yeniden add yapılmalıdır
Callback URL'si	Korunur	Kaldırılır

İlgili Uç Noktalar

• POST /apiv2/time/infinitystart — adresi yeniden etkinleştirin (sonsuz)
• POST /apiv2/time/order — sabit sayıda döngü ile yeniden etkinleştirin
• POST /apiv2/time/status — durumu kontrol edin
• POST /apiv2/time/delete — adresi tamamen kaldırın

Notlar

• Durdurma işlemi adresi Host Mode içinde tutar; istenildiği zaman yeniden etkinleştirilebilir.
• Sipariş edilen kalan döngüler devredilmez — durdurma işleminde kullanılan döngü sayacı sıfırlanır.