POST /apiv2/time/delete

Bir TRON adresini Host Mode'dan tamamen kaldırın. Varsayılan olarak adresin zaten etkin olmaması (durdurulmuş olması) ve açık siparişinin bulunmaması gerekir; adresi tek bir çağrıda durdurup silmek için "stop": true değerini iletin.

Endpoint URL'si

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

Kimlik Doğrulama

API anahtarınızı istek gövdesinde (api_key) veya X-API-KEY başlığında sağlayın. İstek IP'si, API anahtarınız için yapılandırılmış beyaz listede yer almalıdır.

İstek Gövdesi

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

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarı (veya X-API-KEY başlığı).
address	string	Evet	TRON (TRC-20) adresi, ^T[1-9A-HJ-NP-Za-km-z]{33}$. Hesabınıza ait olmalıdır.
stop	boolean	Hayır	true — çağrıyı reddetmek yerine, silmeden önce adresteki Host Mode'u durdurur. /apiv2/time/stop adresine ayrı bir istek yapma ihtiyacını ortadan kaldırır. Varsayılan değer false şeklindedir.

Davranış

• stop olmadan, adres etkin olmamalıdır — etkinse önce /apiv2/time/stop ile durdurun — ve açık siparişi bulunmamalıdır. Aksi takdirde çağrı aşağıdaki hatalarla reddedilir ve hiçbir değişiklik yapılmaz.
• Başarılı olduğunda, adres Host Mode'dan kaldırılır ve kayıtlı geri çağırma URL'si (varsa) silinir.
• Aynı adres daha sonra /apiv2/time/add ile tekrar eklenebilir.

stop

"stop": true ile aktif bir adres tek bir çağrıda durdurulur ve silinir — bu, önce /apiv2/time/stop ve ardından /apiv2/time/delete çağrısı yapmakla aynı sonucu verir ve tamamen aynı eylemleri gerçekleştirir: adres için tüm açık siparişler kapatılır, Host Mode kapatılır, döngü sayacı sıfırlanır ve durdurma işlemi eylem geçmişinize yazılır. Adres ancak bundan sonra silinir.

Her iki adım da tek bir işlemde (transaction) yürütülür: adres ya durdurulup silinir ya da hiçbir şey değişmez. Adresin durdurulmuş ancak yine de kayıtlı kaldığı bir durum söz konusu olamaz.

Bu bayrak yalnızca durdurulacak bir şey olduğunda önem taşır. Zaten etkin olmayan ve açık siparişi bulunmayan bir adreste hiçbir şeyi değiştirmez — çağrı tam olarak bu bayrak olmadan çalıştığı gibi davranır ve yanıt sade silme yanıtı olur.

Faturalandırma etkilenmez: durdurma herhangi bir iade sağlamaz ve silme herhangi bir ücrete tabi değildir. Zaten delege edilmiş döngüler ücretlendirilmiş olarak kalır ve adrese o anda delege edilmiş olan Energy normal takvimine göre geri alınır. Bkz. Host Mode → Döngüler ve Fiyatlandırma.

Örnek İstekler

cURL

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

Tek bir çağrıda durdurun ve silin:

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

Yanıt

Başarılı (200 OK)

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

Adres önce durdurulduğunda başarılı ("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"
    }
}

Yanıt Alanları

Alan	Tür	Açıklama
code	integer	0 = başarılı, negatif = hata
msg	string	İnsan tarafından okunabilir mesaj. Adres çağrının bir parçası olarak durdurulduğunda Address stopped and deleted from Host Mode successfully
data.address	string	Kaldırılan adres
data.stopped	boolean	Yalnızca Host Mode bu çağrının bir parçası olarak durdurulduğunda mevcuttur. Düz bir silme işleminde yer almaz
data.orders_closed	integer	Bu durdurma işlemiyle kapatılan açık sipariş sayısı. Yalnızca stopped ile birlikte bulunur
data.timestamp	string	ISO zaman damgası

Hata Yanıtları

Tüm hatalar code = -1 kullanır:

msg	Neden
API key required in X-API-KEY header or request body	API anahtarı sağlanmadı
Invalid API key or IP not in whitelist	Kimlik doğrulama başarısız oldu
Invalid TRC-20 address format	Geçersiz adres biçimi
Address not found or does not belong to you	Adres hesabınız altında kayıtlı değil
Cannot delete an active address. Stop Host mode first	Adres etkin ve stop ayarlanmamış — önce /apiv2/time/stop çağrısı yapın veya "stop": true ile tekrarlayın
Cannot delete address with active orders	Adresin hâlâ açık siparişleri var ve stop ayarlanmamış — "stop": true ile tekrarlayın
Failed to delete address	Adres kaldırılamadı — tekrar deneyin
Database error deleting address	Sunucu tarafında geçici hata — tekrar deneyin
Internal server error	Beklenmeyen hata — tekrar deneyin veya destekle iletişime geçin

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "data": null }

HTTP durum kodları

Endpoint 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 endpointe 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 — destekle iletişime geçin
422	{"detail": [ … ]}	İstek gövdesi doğrulamadan geçemedi: zorunlu bir alan eksik veya yanlış türe sahip. Bu yanıtta code alanı bulunmadığına dikkat edin

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

İlgili Endpoint'ler

• POST /apiv2/time/stop — silmeden önce adresi durdurun
• POST /apiv2/time/status — durumu ve açık siparişleri kontrol edin
• POST /apiv2/time/add — adresi daha sonra tekrar ekleyin

Notlar

• Silme işlemi, adresin geri çağırma URL'sini de kaldırır.
• Silme işlemine yalnızca açık siparişi olmayan etkin olmayan adresler için izin verilir — önce /apiv2/time/stop ile durdurun veya sizin yerinize durdurulması için burada "stop": true değerini iletin.
• Aynı adres istenildiği zaman tekrar eklenebilir.