POST /apiv2/time/delete

Hapus alamat TRON dari Host Mode sepenuhnya. Secara default, alamat tersebut harus sudah tidak aktif (dihentikan) dan tidak memiliki pesanan terbuka; berikan "stop": true untuk menghentikannya dan menghapusnya dalam satu panggilan.

URL Endpoint

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

Autentikasi

Berikan API key Anda di dalam body permintaan (api_key) atau header X-API-KEY. IP permintaan harus berada di dalam whitelist yang dikonfigurasikan untuk API key Anda.

Body Permintaan

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

Parameter

Parameter	Tipe	Diperlukan	Deskripsi
api_key	string	Ya	API key (atau header X-API-KEY).
address	string	Ya	Alamat TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Harus milik akun Anda.
stop	boolean	Tidak	true — hentikan Host Mode pada alamat sebelum menghapusnya, alih-alih menolak panggilan. Menghemat permintaan terpisah ke /apiv2/time/stop. Default-nya adalah false.

Perilaku

• Tanpa stop, alamat harus dalam keadaan tidak aktif — hentikan terlebih dahulu dengan /apiv2/time/stop jika masih aktif — dan harus tidak memiliki pesanan terbuka. Jika tidak, panggilan akan ditolak dengan error di bawah ini dan tidak ada yang diubah.
• Jika berhasil, alamat akan dihapus dari Host Mode dan URL callback terdaftarnya (jika ada) akan dihapus.
• Alamat yang sama dapat ditambahkan kembali nanti dengan /apiv2/time/add.

stop

Dengan "stop": true, alamat aktif akan dihentikan dan dihapus dalam satu panggilan — hasil yang sama seperti memanggil /apiv2/time/stop lalu /apiv2/time/delete, dan tindakan yang persis sama: semua pesanan terbuka untuk alamat tersebut ditutup, Host Mode dinonaktifkan, penghitung siklus direset, dan penghentian dicatat ke dalam riwayat tindakan Anda. Baru setelah itu alamat dihapus.

Kedua langkah berjalan dalam satu transaksi: alamat dihentikan dan dihapus, atau tidak ada yang berubah sama sekali. Tidak ada kondisi di mana alamat berakhir dalam keadaan terhenti tetapi masih terdaftar.

Flag ini hanya berpengaruh jika ada sesuatu yang perlu dihentikan. Pada alamat yang sudah tidak aktif dan tidak memiliki pesanan terbuka, ini tidak mengubah apa pun — panggilan berperilaku persis seperti tanpa flag tersebut, dan responsnya adalah respons penghapusan biasa.

Penagihan tidak terpengaruh: penghentian tidak mengembalikan dana apa pun dan penghapusan tidak membebankan biaya apa pun. Siklus yang sudah didelegasikan tetap ditagih, dan energi yang saat ini didelegasikan ke alamat akan ditarik kembali sesuai jadwal normalnya. Lihat Host Mode → Siklus dan Harga.

Contoh Permintaan

cURL

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

Hentikan dan hapus dalam satu panggilan:

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

Respons

Berhasil (200 OK)

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

Berhasil ketika alamat dihentikan terlebih dahulu ("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"
    }
}

Bidang Respons

Bidang	Tipe	Deskripsi
code	integer	0 = berhasil, negatif = error
msg	string	Pesan yang dapat dibaca manusia. Address stopped and deleted from Host Mode successfully ketika alamat dihentikan sebagai bagian dari panggilan
data.address	string	Alamat yang dihapus
data.stopped	boolean	Ada hanya ketika Host Mode dihentikan sebagai bagian dari panggilan ini. Tidak ada pada penghapusan biasa
data.orders_closed	integer	Jumlah pesanan terbuka yang ditutup oleh penghentian tersebut. Ada hanya bersamaan dengan stopped
data.timestamp	string	Timestamp ISO

Respons Error

Semua error menggunakan code = -1:

msg	Penyebab
API key required in X-API-KEY header or request body	Tidak ada API key yang diberikan
Invalid API key or IP not in whitelist	Autentikasi gagal
Invalid TRC-20 address format	Format alamat salah
Address not found or does not belong to you	Alamat tidak terdaftar di bawah akun Anda
Cannot delete an active address. Stop Host mode first	Alamat aktif dan stop tidak diatur — panggil /apiv2/time/stop terlebih dahulu, atau ulangi dengan "stop": true
Cannot delete address with active orders	Alamat masih memiliki pesanan terbuka dan stop tidak diatur — ulangi dengan "stop": true
Failed to delete address	Alamat tidak dapat dihapus — coba lagi
Database error deleting address	Error sementara di sisi server — coba lagi
Internal server error	Error tak terduga — coba lagi atau hubungi dukungan

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

Kode status HTTP

Error endpoint dikembalikan dengan HTTP 200 dan code bernilai negatif — periksa code, bukan status HTTP. Body error selalu menyertakan "data": null.

Beberapa error dikembalikan sebelum permintaan mencapai endpoint. Error ini menggunakan status non-200 dan bentuk body yang berbeda:

HTTP	Body	Penyebab
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key diblokir — hubungi dukungan
422	{"detail": [ … ]}	Validasi body permintaan gagal: bidang wajib diisi tidak ada atau memiliki tipe yang salah. Perhatikan bahwa tidak ada bidang code dalam respons ini

Menghapus alamat selalu tersedia terlepas dari saldo akun Anda.

Endpoint Terkait

• POST /apiv2/time/stop — hentikan alamat sebelum menghapus
• POST /apiv2/time/status — periksa status dan pesanan terbuka
• POST /apiv2/time/add — tambahkan kembali alamat nanti

Catatan

• Menghapus juga akan menghapus URL callback alamat tersebut.
• Penghapusan hanya diizinkan untuk alamat yang tidak aktif tanpa pesanan terbuka — hentikan terlebih dahulu dengan /apiv2/time/stop, atau berikan "stop": true di sini agar dihentikan secara otomatis.
• Alamat yang sama dapat ditambahkan kembali kapan saja.