POST /apiv2/time/delete

ลบที่อยู่ TRON ออกจาก Host Mode ทั้งหมด โดยค่าเริ่มต้น ที่อยู่จะต้องอยู่ในสถานะไม่ใช้งาน (หยุดแล้ว) และไม่มีคำสั่งซื้อที่เปิดค้างอยู่ ส่งค่า "stop": true เพื่อหยุดการทำงานและลบออกในการเรียกครั้งเดียว

URL ของ Endpoint

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

การยืนยันตัวตน

ระบุ API key ของคุณในเนื้อหาคำขอ (api_key) หรือในส่วนหัว X-API-KEY โดย IP ของคำขอจะต้องอยู่ในรายการที่อนุญาต (whitelist) ที่กำหนดค่าไว้สำหรับ API key ของคุณ

เนื้อหาคำขอ

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

พารามิเตอร์

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
api_key	string	ใช่	API key (หรือส่วนหัว X-API-KEY)
address	string	ใช่	ที่อยู่ TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$ ต้องเป็นของบัญชีของคุณ
stop	boolean	ไม่	true — หยุด Host Mode บนที่อยู่ดังกล่าวก่อนทำการลบ แทนที่จะปฏิเสธการเรียก ช่วยประหยัดการส่งคำขอแยกไปยัง /apiv2/time/stop ค่าเริ่มต้นคือ false

พฤติกรรมการทำงาน

• หากไม่มี stop ที่อยู่จะต้องอยู่ในสถานะไม่ใช้งาน — ให้หยุดการทำงานก่อนด้วย /apiv2/time/stop หากยังทำงานอยู่ — และต้องไม่มีคำสั่งซื้อที่เปิดค้างอยู่ มิฉะนั้น การเรียกจะถูกปฏิเสธพร้อมข้อผิดพลาดด้านล่างและไม่มีการเปลี่ยนแปลงใดๆ เกิดขึ้น
• เมื่อสำเร็จ ที่อยู่จะถูกลบออกจาก Host Mode และ callback URL ที่ลงทะเบียนไว้ (ถ้ามี) จะถูกลบออก
• ที่อยู่เดิมสามารถเพิ่มเข้ามาใหม่ได้ในภายหลังด้วย /apiv2/time/add

stop

เมื่อกำหนด "stop": true ที่อยู่ที่กำลังทำงานอยู่จะถูกหยุดและลบออกในการเรียกครั้งเดียว — ได้ผลลัพธ์เหมือนกับการเรียก /apiv2/time/stop แล้วตามด้วย /apiv2/time/delete และมีการทำงานที่เหมือนกันทุกประการ: คำสั่งซื้อที่เปิดค้างอยู่ทั้งหมดสำหรับที่อยู่นี้จะถูกปิด, Host Mode จะถูกปิดการทำงาน, ตัวนับรอบ (cycle counter) จะถูกรีเซ็ต และการหยุดจะถูกบันทึกลงในประวัติการดำเนินการของคุณ หลังจากนั้นที่อยู่จึงจะถูกลบ

ทั้งสองขั้นตอนทำงานในธุรกรรมเดียว (one transaction): ที่อยู่อาจจะถูกหยุดและลบออก หรือไม่มีอะไรเปลี่ยนแปลงเลย จะไม่มีสถานะที่ที่อยู่ถูกหยุดแต่ยังคงลงทะเบียนไว้อยู่

แฟล็กนี้จะมีผลเมื่อมีสิ่งที่ต้องหยุดเท่านั้น หากใช้กับที่อยู่ที่ไม่ใช้งานอยู่แล้วและไม่มีคำสั่งซื้อที่เปิดค้างอยู่ แฟล็กนี้จะไม่เปลี่ยนแปลงสิ่งใด — การเรียกจะทำงานเหมือนกับไม่มีแฟล็กดังกล่าว และการตอบกลับจะเป็นการตอบกลับการลบทั่วไป

การเรียกเก็บเงินจะไม่ได้รับผลกระทบ: การหยุดจะไม่มีการคืนเงินใดๆ และการลบจะไม่มีการเรียกเก็บเงินเพิ่มเติม รอบที่ได้รับการมอบสิทธิ์ไปแล้วจะยังคงถูกคิดค่าบริการ และ Energy ที่มอบสิทธิ์ให้กับที่อยู่นั้นอยู่ในปัจจุบันจะถูกเรียกคืนตามกำหนดการปกติ ดูที่ Host Mode → รอบและราคา

ตัวอย่างคำขอ

cURL

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

หยุดและลบในการเรียกครั้งเดียว:

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

การตอบกลับ

สำเร็จ (200 OK)

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

สำเร็จเมื่อที่อยู่ถูกหยุดก่อน ("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"
    }
}

ฟิลด์การตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
code	integer	0 = สำเร็จ, ค่าลบ = ข้อผิดพลาด
msg	string	ข้อความที่มนุษย์อ่านได้ Address stopped and deleted from Host Mode successfully เมื่อที่อยู่ถูกหยุดซึ่งเป็นส่วนหนึ่งของการเรียกนี้
data.address	string	ที่อยู่ซึ่งถูกลบออก
data.stopped	boolean	ปรากฏเฉพาะเมื่อ Host Mode ถูกหยุดซึ่งเป็นส่วนหนึ่งของการเรียกนี้ จะไม่มีเมื่อเป็นการลบแบบธรรมดา
data.orders_closed	integer	จำนวนคำสั่งซื้อที่เปิดค้างอยู่ซึ่งถูกปิดโดยการหยุดนั้น ปรากฏเฉพาะคู่กับ stopped
data.timestamp	string	การประทับเวลาแบบ ISO

การตอบกลับข้อผิดพลาด

ข้อผิดพลาดทั้งหมดใช้ code = -1:

msg	สาเหตุ
API key required in X-API-KEY header or request body	ไม่ได้ระบุ API key
Invalid API key or IP not in whitelist	การยืนยันตัวตนล้มเหลว
Invalid TRC-20 address format	รูปแบบที่อยู่ไม่ถูกต้อง
Address not found or does not belong to you	ไม่พบที่อยู่หรือไม่ใช่ที่อยู่ของบัญชีของคุณ
Cannot delete an active address. Stop Host mode first	ที่อยู่กำลังทำงานอยู่และไม่ได้ตั้งค่า stop — ให้เรียก /apiv2/time/stop ก่อน หรือลองใหม่อีกครั้งพร้อมกำหนด "stop": true
Cannot delete address with active orders	ที่อยู่ยังมีคำสั่งซื้อที่เปิดค้างอยู่และไม่ได้ตั้งค่า stop — ให้ลองใหม่อีกครั้งพร้อมกำหนด "stop": true
Failed to delete address	ไม่สามารถลบที่อยู่ออกได้ — ลองใหม่อีกครั้ง
Database error deleting address	ข้อผิดพลาดชั่วคราวที่ฝั่งเซิร์ฟเวอร์ — ลองใหม่อีกครั้ง
Internal server error	ข้อผิดพลาดที่ไม่คาดคิด — ลองใหม่อีกครั้งหรือติดต่อฝ่ายสนับสนุน

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

รหัสสถานะ HTTP

ข้อผิดพลาดของ Endpoint จะถูกส่งกลับมาพร้อมกับ HTTP 200 และค่า code ติดลบ — ให้ตรวจสอบที่ code ไม่ใช่สถานะ HTTP ข้อมูลข้อผิดพลาดจะมี "data": null รวมอยู่ด้วยเสมอ

ข้อผิดพลาดบางอย่างจะถูกส่งกลับมาก่อนที่คำขอจะไปถึง endpoint ข้อผิดพลาดเหล่านี้จะใช้สถานะที่ไม่ใช่ 200 และมีรูปแบบเนื้อหาที่ต่างออกไป:

HTTP	เนื้อหา	สาเหตุ
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key ถูกบล็อก — ติดต่อฝ่ายสนับสนุน
422	{"detail": [ … ]}	เนื้อหาคำขอไม่ผ่านการตรวจสอบ: ฟิลด์ที่จำเป็นขาดหายไปหรือมีชนิดข้อมูลไม่ถูกต้อง โปรดทราบว่าจะไม่มีฟิลด์ code ในการตอบกลับนี้

การลบที่อยู่สามารถทำได้เสมอไม่ว่ายอดเงินในบัญชีของคุณจะเป็นอย่างไร

Endpoint ที่เกี่ยวข้อง

• POST /apiv2/time/stop — หยุดการทำงานของที่อยู่นี้ก่อนทำการลบ
• POST /apiv2/time/status — ตรวจสอบสถานะและคำสั่งซื้อที่เปิดค้างอยู่
• POST /apiv2/time/add — เพิ่มที่อยู่นี้อีกครั้งในภายหลัง

หมายเหตุ

• การลบจะเป็นการลบ callback URL ของที่อยู่นั้นออกด้วย
• อนุญาตให้ลบได้เฉพาะที่อยู่ที่ไม่มีการใช้งานและไม่มีคำสั่งซื้อที่เปิดค้างอยู่เท่านั้น — ให้หยุดการทำงานก่อนด้วย /apiv2/time/stop หรือส่งค่า "stop": true ที่นี่เพื่อให้ระบบหยุดการทำงานให้คุณ
• สามารถเพิ่มที่อยู่เดิมกลับเข้ามาใหม่ได้ตลอดเวลา