NETTS

Tiếng Việt

English
Русский
Español
简体中文
Türkçe
Português (Brasil)
Bahasa Indonesia
ไทย
Українська
اردو
हिन्दी

Tiếng Việt

English
Русский
Español
简体中文
Türkçe
Português (Brasil)
Bahasa Indonesia
ไทย
Українська
اردو
हिन्दी

Appearance

Translated page. The English version is the source of truth.

POST /apiv2/time/delete ​

Xóa hoàn toàn một địa chỉ TRON khỏi Host Mode. Theo mặc định, địa chỉ phải đang ở trạng thái không hoạt động (đã dừng) và không có đơn hàng nào đang mở; truyền "stop": true để dừng và xóa địa chỉ đó trong một lệnh gọi duy nhất.

URL Endpoint ​

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

Xác thực ​

Cung cấp API key của bạn trong phần thân yêu cầu (api_key) hoặc tiêu đề X-API-KEY. IP yêu cầu phải nằm trong danh sách trắng (whitelist) đã được cấu hình cho API key của bạn.

Thân yêu cầu (Request Body) ​

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

Tham số ​

Tham sốLoạiBắt buộcMô tả
api_keystringCóAPI key (hoặc tiêu đề X-API-KEY).
addressstringCóĐịa chỉ TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Phải thuộc tài khoản của bạn.
stopbooleanKhôngtrue — dừng Host Mode trên địa chỉ trước khi xóa, thay vì từ chối lệnh gọi. Tiết kiệm một yêu cầu riêng biệt tới /apiv2/time/stop. Mặc định là false.

Hành vi ​

  • Nếu không có stop, địa chỉ bắt buộc phải không hoạt động — hãy dừng địa chỉ trước bằng /apiv2/time/stop nếu nó đang hoạt động — và phải không có đơn hàng nào đang mở. Nếu không, lệnh gọi sẽ bị từ chối với các lỗi bên dưới và không có gì bị thay đổi.
  • Khi thành công, địa chỉ sẽ bị xóa khỏi Host Mode và URL callback đã đăng ký của nó (nếu có) cũng sẽ bị xóa.
  • Cùng một địa chỉ có thể được thêm lại sau này bằng /apiv2/time/add.

stop ​

Với "stop": true, một địa chỉ đang hoạt động sẽ được dừng và xóa trong một lệnh gọi duy nhất — mang lại kết quả tương tự như việc gọi /apiv2/time/stop rồi sau đó gọi /apiv2/time/delete, và thực hiện các hành động hoàn toàn giống nhau: tất cả các đơn hàng đang mở cho địa chỉ sẽ bị đóng, Host Mode bị tắt, bộ đếm chu kỳ được đặt lại, và hành động dừng được ghi vào lịch sử hoạt động của bạn. Chỉ sau đó, địa chỉ mới được xóa.

Cả hai bước đều chạy trong một giao dịch (transaction): hoặc địa chỉ được dừng và xóa, hoặc hoàn toàn không có gì thay đổi. Sẽ không có trạng thái nào mà địa chỉ đã bị dừng nhưng vẫn còn được đăng ký.

Cờ này chỉ có ý nghĩa khi có thứ gì đó cần dừng. Đối với một địa chỉ vốn đã không hoạt động và không có đơn hàng đang mở, nó không thay đổi bất kỳ điều gì — lệnh gọi hoạt động chính xác như khi không có cờ này, và phản hồi trả về là phản hồi xóa thông thường.

Việc thanh toán không bị ảnh hưởng: thao tác dừng không hoàn lại tiền và thao tác xóa không tính bất kỳ khoản phí nào. Các chu kỳ đã được ủy quyền vẫn bị tính phí, và Energy hiện đang được ủy quyền cho địa chỉ sẽ được thu hồi theo lịch trình thông thường. Xem Host Mode → Chu kỳ và Giá cả.

Yêu cầu mẫu ​

cURL ​

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

Dừng và xóa trong một lệnh gọi duy nhất:

bash
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 ​

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 ​

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

Phản hồi ​

Thành công (200 OK) ​

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

Thành công khi địa chỉ được dừng trước ("stop": true) ​

json
{
    "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"
    }
}

Các trường phản hồi ​

TrườngLoạiMô tả
codeinteger0 = thành công, số âm = lỗi
msgstringThông điệp rõ ràng cho người đọc. Address stopped and deleted from Host Mode successfully khi địa chỉ đã được dừng lại như một phần của lệnh gọi
data.addressstringĐịa chỉ đã bị xóa
data.stoppedbooleanChỉ xuất hiện khi Host Mode đã được dừng lại như một phần của lệnh gọi này. Không xuất hiện khi xóa thông thường
data.orders_closedintegerSố lượng đơn hàng đang mở đã bị đóng bởi thao tác dừng đó. Chỉ xuất hiện cùng với stopped
data.timestampstringDấu thời gian ISO

Phản hồi lỗi ​

Tất cả các lỗi đều sử dụng code = -1:

msgNguyên nhân
API key required in X-API-KEY header or request bodyKhông có API key nào được cung cấp
Invalid API key or IP not in whitelistXác thực thất bại
Invalid TRC-20 address formatĐịnh dạng địa chỉ không hợp lệ
Address not found or does not belong to youĐịa chỉ không được đăng ký dưới tài khoản của bạn
Cannot delete an active address. Stop Host mode firstĐịa chỉ đang hoạt động và stop không được đặt — hãy gọi /apiv2/time/stop trước, hoặc lặp lại với "stop": true
Cannot delete address with active ordersĐịa chỉ vẫn còn đơn hàng đang mở và stop không được đặt — hãy lặp lại với "stop": true
Failed to delete addressKhông thể xóa địa chỉ — hãy thử lại
Database error deleting addressLỗi tạm thời phía máy chủ — hãy thử lại
Internal server errorLỗi không mong muốn — hãy thử lại hoặc liên hệ bộ phận hỗ trợ
json
{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "data": null }

Mã trạng thái HTTP ​

Các lỗi endpoint được trả về với HTTP 200 và code âm — hãy kiểm tra code, không phải trạng thái HTTP. Phần thân lỗi luôn bao gồm "data": null.

Một số lỗi được trả về trước khi yêu cầu đến được endpoint. Chúng sử dụng trạng thái khác 200 và cấu trúc phần thân khác:

HTTPThân phản hồiNguyên nhân
403{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}API key bị khóa — liên hệ bộ phận hỗ trợ
422{"detail": [ … ]}Thân yêu cầu không vượt qua kiểm tra tính hợp lệ: thiếu trường bắt buộc hoặc trường có loại dữ liệu sai. Lưu ý rằng không có trường code trong phản hồi này

Việc xóa một địa chỉ luôn khả dụng bất kể số dư tài khoản của bạn là bao nhiêu.

Các endpoint liên quan ​

Ghi chú ​

  • Việc xóa cũng sẽ xóa URL callback của địa chỉ.
  • Thao tác xóa chỉ được phép đối với các địa chỉ không hoạt động và không có đơn hàng đang mở — hãy dừng địa chỉ trước bằng /apiv2/time/stop, hoặc truyền "stop": true tại đây để hệ thống tự động dừng giúp bạn.
  • Cùng một địa chỉ có thể được thêm lại bất kỳ lúc nào.