POST /apiv2/time/stop

หยุดการทำงานของ Host Mode สำหรับที่อยู่ TRON: ปิดคำสั่งซื้อที่เปิดอยู่และปิดใช้งาน ที่อยู่จะยังคงลงทะเบียนอยู่ใน Host Mode และสามารถเปิดใช้งานใหม่ได้ในภายหลัง

URL ของ Endpoint

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

การตรวจสอบสิทธิ์

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

เนื้อหาคำขอ

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

พารามิเตอร์

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

พฤติกรรม

การหยุดที่อยู่:

• ปิดคำสั่งซื้อทั้งหมดที่เปิดอยู่ของที่อยู่นั้น
• กำหนดค่า Host Mode เป็น ไม่ใช้งาน (status = 0, cycle_set = 0)
• รีเซ็ตตัวนับรอบที่ใช้งานแล้วสำหรับที่อยู่นี้
• จะไม่มีการมอบสิทธิ์ Energy ใหม่จนกว่าคุณจะเปิดใช้งานอีกครั้ง (ด้วย /apiv2/time/order หรือ /apiv2/time/infinitystart)

ตัวที่อยู่เองจะยังคงอยู่ใน Host Mode หากต้องการลบออกอย่างสมบูรณ์ให้ใช้ /apiv2/time/delete

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

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

การตอบกลับ

สำเร็จ (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"
    }
}

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

ฟิลด์	ชนิด	คำอธิบาย
code	integer	0 = สำเร็จ, ค่าติดลบ = ข้อผิดพลาด
msg	string	ข้อความที่มนุษย์สามารถอ่านได้
data.address	string	ที่อยู่ที่ถูกหยุดการทำงาน
data.orders_closed	integer	จำนวนคำสั่งซื้อที่เปิดอยู่ซึ่งถูกปิดไป
data.status	string	"inactive"
data.timestamp	string	เวลาแบบ ISO

การตอบกลับเมื่อเกิดข้อผิดพลาด

code	msg	สาเหตุ
-1	API key required in X-API-KEY header or request body	ไม่ได้ระบุ API key
-1	Invalid API key or IP not in whitelist	การตรวจสอบสิทธิ์ล้มเหลว
-1	Invalid TRC-20 address format	รูปแบบที่อยู่ไม่ถูกต้อง
-1	Database error stopping host mode	ข้อผิดพลาดชั่วคราวฝั่งเซิร์ฟเวอร์ — ให้ลองใหม่อีกครั้ง
-1	Internal server error	เกิดข้อผิดพลาดที่ไม่คาดคิด — ให้ลองใหม่อีกครั้งหรือติดต่อฝ่ายสนับสนุน
-4	Address not found	ไม่พบที่อยู่นี้ใน Host Mode ภายใต้บัญชีของคุณ
-7	Host mode is already inactive	ที่อยู่นี้ถูกหยุดการทำงานอยู่แล้ว

{ "code": -7, "msg": "Host mode is already inactive", "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 ในการตอบกลับนี้

การหยุดที่อยู่สามารถทำได้ตลอดเวลาโดยไม่ขึ้นกับยอดคงเหลือในบัญชีของคุณ

การ Stop เทียบกับ การ Delete

	Stop	Delete
การลงทะเบียน Host Mode	คงไว้	ถูกลบออก
คำสั่งซื้อที่เปิดอยู่	ปิด	ต้องไม่มีคำสั่งซื้อค้างอยู่
การเปิดใช้งานใหม่	order / infinitystart	ต้อง add ใหม่อีกครั้ง
URL สำหรับ Callback	คงไว้	ถูกลบออก

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

• POST /apiv2/time/infinitystart — เปิดใช้งานที่อยู่อีกครั้ง (infinity)
• POST /apiv2/time/order — เปิดใช้งานอีกครั้งโดยกำหนดจำนวนรอบคงที่
• POST /apiv2/time/status — ตรวจสอบสถานะ
• POST /apiv2/time/delete — ลบที่อยู่ออกอย่างสมบูรณ์

หมายเหตุ

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