POST /apiv2/time/infinitystart
เปิดใช้งานโหมดอินฟินิตี้ (ไม่จำกัด) สำหรับที่อยู่ที่อยู่ใน Host Mode อยู่แล้ว — Energy จะได้รับการมอบสิทธิ์อย่างต่อเนื่องรอบแล้วรอบเล่าจนกว่าคุณจะสั่งหยุด
URL ของ Endpoint
POST https://netts.io/apiv2/time/infinitystartการยืนยันตัวตน
ระบุ API key ของคุณในเนื้อหาคำขอ (api_key) หรือในส่วนหัว X-API-KEY IP ของคำขอจะต้องอยู่ในไวท์ลิสต์ที่กำหนดค่าไว้สำหรับ 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 และต้องมีสถานะ ไม่ทำงาน (หยุดอยู่)
- ยอดคงเหลือของคุณต้องครอบคลุมอย่างน้อยหนึ่งรอบตามราคาปัจจุบัน (มีการตรวจสอบก่อนเปิดใช้งาน)
- Endpoint นี้จะเปิดใช้งานที่อยู่ สร้างคำสั่งซื้อโหมดอินฟินิตี้ที่เปิดอยู่ และ Host Mode จะทำการมอบสิทธิ์ Energy ต่อเนื่องรอบแล้วรอบเล่าจนกว่าคุณจะเรียกใช้
/apiv2/time/stop
รอบการใช้งานจะถูกเรียกเก็บเงินเมื่อมีการมอบสิทธิ์ (หนึ่งรอบต่อการมอบสิทธิ์หนึ่งครั้ง) การมอบสิทธิ์ครั้งแรกของการเปิดใช้งานมีค่าใช้จ่าย 4 TRX; ในแต่ละครั้งถัดไปจะมีค่าใช้จ่าย 2 หรือ 4 TRX ขึ้นอยู่กับ Energy ที่การโอนก่อนหน้าของคุณใช้งานไปจริง (≤ 65,000 → 2 TRX, มากกว่านั้น → 4 TRX) ข้อกำหนดยอดขั้นต่ำรายวัน 8 TRX (มีผลบังคับใช้ 2026-08-29) และการปิดระบบเมื่อไม่มีการใช้งานเป็นเวลา 2 วัน จะมีผลบังคับใช้ในโหมดอินฟินิตี้ด้วยเช่นกัน — ดูที่ Host Mode → รอบและราคา และ ยอดขั้นต่ำรายวัน
ใน Time Status ที่อยู่ในโหมดอินฟินิตี้จะรายงาน cycles_ordered และ cycles_remaining เป็น null — เนื่องจากไม่มีการจำกัดจำนวนที่จะต้องนับถอยหลัง ให้เข้าใจค่า null ว่าหมายถึง "ไม่จำกัด" ไม่ใช่ "ไม่เหลือรอบการใช้งาน"
ตัวอย่างคำขอ
cURL
curl -X POST https://netts.io/apiv2/time/infinitystart \
-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/infinitystart",
json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
timeout=30,
)
result = resp.json()
if result["code"] == 0:
print("Infinity mode active, order:", result["data"]["order_id"])
else:
print("Error:", result["msg"])Node.js
const axios = require('axios');
axios.post('https://netts.io/apiv2/time/infinitystart', {
api_key: 'YOUR_API_KEY_HERE',
address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));ผลตอบกลับ
สำเร็จ (200 OK)
{
"code": 0,
"msg": "Infinity mode activated successfully",
"data": {
"address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
"order_id": 5427,
"mode": "infinity",
"status": "active",
"timestamp": "2026-07-13T05:30:15.123456"
}
}ฟิลด์ผลตอบกลับ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | integer | 0 = สำเร็จ, ค่าลบ = เกิดข้อผิดพลาด |
| msg | string | ข้อความที่มนุษย์อ่านเข้าใจได้ |
| data.address | string | ที่อยู่ที่ได้รับการเปิดใช้งานในโหมดอินฟินิตี้ |
| data.order_id | integer | ตัวระบุคำสั่งซื้อภายใน |
| data.mode | string | "infinity" |
| data.status | string | "active" |
| 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 | Failed to activate host mode | ไม่สามารถเปิดใช้งาน Host Mode ได้ — ให้ลองอีกครั้ง |
| -1 | Database error activating infinity mode | ข้อผิดพลาดชั่วคราวฝั่งเซิร์ฟเวอร์ — ให้ลองอีกครั้ง |
| -1 | Internal server error | ข้อผิดพลาดที่ไม่คาดคิด — ให้ลองอีกครั้งหรือติดต่อฝ่ายสนับสนุน |
| -2 | Insufficient balance. Required: X TRX, Available: Y TRX | ยอดคงเหลือต่ำกว่าราคาหนึ่งรอบ |
| -4 | Address not found. Please add address first | ไม่พบที่อยู่ใน Host Mode |
| -5 | Host mode is already active for this address | ที่อยู่นี้กำลังทำงานอยู่แล้ว |
| -6 | There is already an open order for this address | มีคำสั่งซื้อที่เปิดอยู่แล้วสำหรับที่อยู่นี้ |
{ "code": -4, "msg": "Address not found. Please add address first", "data": null }รหัสสถานะ HTTP
ข้อผิดพลาดของ endpoint จะถูกส่งกลับมาพร้อมกับ HTTP 200 และ code ที่มีค่าเป็นลบ — ให้ตรวจสอบที่ code ไม่ใช่สถานะ HTTP โครงสร้างเนื้อหาข้อผิดพลาดจะมี "data": null เสมอ
ข้อผิดพลาดบางอย่างจะถูกส่งกลับมาก่อนที่คำขอจะไปถึง endpoint ข้อผิดพลาดเหล่านี้จะใช้สถานะที่ไม่ใช่ 200 และมีรูปแบบเนื้อหาที่แตกต่างกัน:
| HTTP | เนื้อหา | สาเหตุ |
|---|---|---|
| 402 | {"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}} | ยอดคงเหลือในบัญชีต่ำเกินไป |
| 403 | {"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}} | API key ถูกบล็อก — ติดต่อฝ่ายสนับสนุน |
| 422 | {"detail": [ … ]} | เนื้อหาคำขอล้มเหลวในการตรวจสอบความถูกต้อง: ฟิลด์ที่จำเป็นขาดหายไปหรือมีประเภทข้อมูลที่ไม่ถูกต้อง โปรดทราบว่าไม่มีฟิลด์ code ในการตอบกลับนี้ |
ที่อยู่ปลายทางไม่อนุญาต (403)
จะมีการตรวจสอบที่อยู่ก่อนที่จะเริ่มเปิดใช้งาน หากไม่อนุญาตให้มอบสิทธิ์ทรัพยากรไปยังที่อยู่นั้น คำขอจะถูกปฏิเสธด้วย HTTP 403 และไม่มีข้อมูลใดถูกบันทึก — ที่อยู่จะยังคงไม่ทำงานและไม่มีคำสั่งซื้อถูกสร้างขึ้น เนื้อหาจะใช้รูปแบบ detail:
| code | msg | ความหมาย |
|---|---|---|
| 1006 | Address is blocked. Contact support. | ที่อยู่ถูกบล็อก |
| 1007 | Energy rental to smart contracts is not supported. | ที่อยู่นี้คือสมาร์ตคอนแทรกต์ (ที่อยู่กระเป๋าเงิน GasFree ก็ถือเป็นสมาร์ตคอนแทรกต์เช่นกัน) |
| 1010 | Resource delegation to this address is not available. | ไม่พร้อมให้บริการมอบสิทธิ์ทรัพยากรไปยังที่อยู่นี้ |
| 1011 | This address is frozen and cannot receive resource delegation. | ที่อยู่นี้ถูกระงับ (frozen) และไม่สามารถรับการมอบสิทธิ์ทรัพยากรได้ |
{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }Endpoint ที่เกี่ยวข้อง
- POST /apiv2/time/add — เพิ่มที่อยู่ก่อน
- POST /apiv2/time/order — ซื้อตามจำนวนรอบคงที่แทน
- POST /apiv2/time/stop — หยุดโหมดอินฟินิตี้
- POST /apiv2/time/status — ตรวจสอบสถานะ
หมายเหตุ
- โหมดอินฟินิตี้จะทำงานอย่างต่อเนื่องจนกว่าคุณจะสั่งหยุดด้วย
/apiv2/time/stop - รักษาเงินคงเหลือให้เพียงพอ — ค่าบริการรอบการใช้งานจะถูกหักเมื่อมีการมอบสิทธิ์
- ใช้ endpoint นี้เพื่อกลับมาเปิดใช้งานที่อยู่ที่เคยถูกหยุดไว้ก่อนหน้านี้อีกครั้ง (ที่อยู่จะต้องมีสถานะไม่ทำงาน)