บันทึกการเปลี่ยนแปลง (Changelog)
ยินดีต้อนรับสู่ บันทึกการเปลี่ยนแปลงของแพลตฟอร์ม Netts (Netts Platform Changelog) — บันทึกทางเทคนิคฉบับสมบูรณ์ที่รวบรวมการอัปเดต การปรับปรุง และฟีเจอร์ใหม่ทั้งหมดที่นำมาใช้งานทั่วทั้งระบบนิเวศของ Netts
ส่วนนี้ให้ข้อมูลโดยละเอียดเกี่ยวกับ:
- การปรับปรุง API และจุดสิ้นสุด (endpoints) ใหม่
- การเพิ่มประสิทธิภาพการทำงาน และการปรับปรุงโครงสร้างพื้นฐาน
- การแก้ไขข้อผิดพลาด (Bug fixes) และการอัปเดตความเสถียร
- ฟีเจอร์ใหม่ และการเพิ่มฟังก์ชันการทำงาน
- การเปลี่ยนแปลงที่ส่งผลกระทบต่อระบบเดิม (Breaking changes) และคู่มือการย้ายข้อมูล (migration guides)
รายการทั้งหมดได้รับการบันทึกในรูปแบบทางเทคนิคระดับมืออาชีพพร้อมรายละเอียดการนำไปใช้งาน ส่วนประกอบที่ได้รับผลกระทบ และข้อมูลเวอร์ชัน
การอัปเดตล่าสุด
21 มกราคม 2026 - ลดขีดจำกัดสูงสุดของคำสั่งซื้อ Energy
ประเภท: ⚠️ Breaking Change
สรุป: ลดจำนวน Energy สูงสุดต่อหนึ่งคำสั่งซื้อจาก 5,000,000 เหลือ 3,000,000 หน่วย
รายละเอียด:
- Energy สูงสุดต่อหนึ่งคำสั่งซื้อ: 5,000,000 → 3,000,000
- Energy ขั้นต่ำยังคงไม่เปลี่ยนแปลง: 61,000
- ผู้ใช้ที่ต้องการ Energy มากกว่า 3M ควรแบ่งออกเป็นหลายคำสั่งซื้อ
ส่วนประกอบที่ได้รับผลกระทบ:
- API: การตรวจสอบความถูกต้องของ endpoint
/apiv2/order1h - เอกสารประกอบ: Order 1h
3 ธันวาคม 2025 - Endpoint สำหรับตรวจสอบคำสั่งซื้อใหม่
ประเภท: Feature
สรุป: เพิ่ม API endpoint ใหม่ /apiv2/order_check สำหรับการเรียกดูข้อมูลโดยละเอียดเกี่ยวกับคำสั่งซื้อ Energy แบบ 1 ชั่วโมง
รายละเอียด:
- รับรายละเอียดคำสั่งซื้อรวมถึงค่าใช้จ่าย จำนวน Energy ที่อยู่ปลายทาง และ transaction hashes
- ดูข้อมูลการเปิดใช้งาน (activation) หากที่อยู่ได้รับการเปิดใช้งาน
- ผู้ใช้ระดับ Parent สามารถดูรายละเอียดส่วนเพิ่มราคา (markup breakdown) ของ subuser ได้ (
energy_markup,activation_markup,net_cost) - รองรับการตรวจสอบความเป็นเจ้าของและการควบคุมการเข้าถึงระหว่าง parent-subuser
ส่วนประกอบที่ได้รับผลกระทบ:
- API: endpoint
/apiv2/order_checkใหม่ - เอกสารประกอบ: Order Check
3 ธันวาคม 2025 - ปรับปรุงรหัสสถานะ HTTP สำหรับ Idempotency และเพิ่มประสิทธิภาพการทำงาน
ประเภท: Enhancement
สรุป: อัปเดตรหัสสถานะ HTTP สำหรับการตอบกลับของ idempotency เพื่อให้ผลตอบรับที่ชัดเจนยิ่งขึ้นสำหรับคำขอที่ซ้ำซ้อน รวมถึงปรับปรุงการประมวลผล internal pool ให้มีเวลาตอบสนองต่ำกว่าหนึ่งวินาที
รายละเอียด:
การเปลี่ยนแปลงรหัสสถานะ HTTP:
- 208 Already Reported - จะถูกส่งกลับเมื่อได้รับคำขอที่ซ้ำกันสำหรับคำสั่งซื้อที่ได้รับการประมวลผลแล้ว (ก่อนหน้านี้ส่งกลับ 200)
- 409 Conflict - จะถูกส่งกลับเมื่อคำขอที่ซ้ำกันมาถึงในขณะที่คำขอเดิมยังอยู่ระหว่างการประมวลผล (ก่อนหน้านี้ส่งกลับ 200)
- เนื้อหาการตอบกลับ (Response body) ยังคงไม่เปลี่ยนแปลง - แตกต่างเพียงรหัสสถานะ HTTP เท่านั้น
การเพิ่มประสิทธิภาพการทำงาน:
- การประมวลผลคำสั่งซื้อของ internal pool ขณะนี้เสร็จสิ้นภายในเวลาไม่ถึง 1 วินาที (รวมถึงการเปิดใช้งานที่อยู่)
- เวลาตอบสนองทั่วไป: 500-700ms สำหรับคำสั่งซื้อของ internal pool
- ระบบสำรองผู้ให้บริการภายนอก (External provider fallback) ยังคงรักษาคุณลักษณะด้านประสิทธิภาพตามเดิม
เหตุผลที่การเปลี่ยนแปลงนี้มีความสำคัญ:
- แยกความแตกต่างอย่างชัดเจนระหว่างคำขอแรกที่สำเร็จ (200) และการตอบกลับที่แคชไว้/ซ้ำกัน (208/409)
- ไคลเอนต์สามารถตรวจจับการตอบกลับที่ซ้ำซ้อนได้อย่างง่ายดายโดยการตรวจสอบรหัสสถานะ HTTP
- ป้องกันความสับสนเมื่อได้รับ 200 OK สำหรับคำขอที่ได้รับการประมวลผลไปแล้ว
- ปรับปรุงความเร็วในการประมวลผลเพื่อประสบการณ์การใช้งานที่ดียิ่งขึ้น
ส่วนประกอบที่ได้รับผลกระทบ:
- API: endpoint
/apiv2/order1h - โมดูลจัดการ Idempotency
- การประมวลผลคำสั่งซื้อของ internal pool
19 พฤศจิกายน 2025 - ปรับปรุงการคำนวณยอดคงเหลือใน API และเว็บไซต์
ประเภท: ⚡ Enhancement
สรุป: อัปเดตตรรกะการคำนวณยอดคงเหลือใน API endpoint /apiv2/userinfo และส่วน Wallet บนเว็บไซต์เพื่อแสดง Total Balance TRX ที่รวมธุรกรรมที่รอดำเนินการทั้งหมด
รายละเอียด:
การเปลี่ยนแปลง API (/apiv2/userinfo):
- ฟิลด์
balanceในการตอบกลับของ API ขณะนี้จะส่งกลับ Total Balance TRX แทนที่จะเป็นเพียงยอดคงเหลือจากการฝาก - Total Balance TRX ประกอบด้วย:
- ยอดคงเหลือในกระเป๋าเงินฝาก (Deposit wallet balance)
- ยอดการจ่ายเงินที่รอดำเนินการ (Robot & Sub-users)
- หักยอดการถอนเงินที่รอดำเนินการ
การเปลี่ยนแปลงเว็บไซต์ (ส่วน Wallet):
- อัปเดตการแสดงผลยอดคงเหลือเพื่อแสดง Total Balance TRX จาก API
- ปรับตรรกะฝั่ง frontend ให้เรียบง่ายขึ้น - ลบการคำนวณที่ซ้ำซ้อนออก
- เพิ่มทูลทิป (tooltip) ที่ให้ข้อมูลอธิบายส่วนประกอบของยอดคงเหลือ
ข้อสำคัญ:
- TRX จากการจ่ายเงินของ Robot & Sub-users จะถูกโอนเข้าที่อยู่สำหรับฝาก 2 ครั้งต่อวัน
- ก่อนการโอนเข้า TRX จากการจ่ายเงินของ Robot & Sub-users ไม่สามารถนำมาใช้ สำหรับการซื้อ Energy ได้
- หากต้องการถอน TRX/USDT จากการจ่ายเงินของ Robot & Sub-users ให้เปิดใช้งานช่องทำเครื่องหมายในแบบฟอร์มการถอนเงิน
ส่วนประกอบที่ได้รับผลกระทบ:
- API: endpoint
/apiv2/userinfo - เว็บไซต์: หน้า Wallet (Deposit & Withdraw)
- Backend: ตรรกะการคำนวณยอดคงเหลือ
19 พฤศจิกายน 2025 - การเริ่มต้นบันทึกการเปลี่ยนแปลง (Changelog Initialization)
ประเภท: 📚 Documentation
สรุป: การจัดทำบันทึกการเปลี่ยนแปลงของแพลตฟอร์ม Netts ในระยะเริ่มต้น ซึ่งถือเป็นจุดเริ่มต้นของบันทึกทางเทคนิคสาธารณะของเรา โดยเราจะบันทึกการเปลี่ยนแปลงที่สำคัญ การปรับปรุง และฟีเจอร์ใหม่ทั้งหมด
รายละเอียด:
- กำหนดโครงสร้างบันทึกการเปลี่ยนแปลงและรูปแบบเอกสารประกอบ
- สร้างส่วนเฉพาะในเว็บไซต์เอกสารประกอบ
- ใช้งานระบบติดตามการอัปเดตแบบระบุเวอร์ชัน
วัตถุประสงค์: เพื่อมอบความโปร่งใสและการสื่อสารที่ชัดเจนเกี่ยวกับวิวัฒนาการของแพลตฟอร์มแก่ผู้ใช้ นักพัฒนา และพาร์ทเนอร์การผสานรวมระบบของเรา
คลังข้อมูลย้อนหลัง
การอัปเดตก่อนหน้านี้จะแสดงรายการไว้ที่นี่เมื่อเกิดขึ้น โดยจัดเรียงตามวันที่จากใหม่ไปเก่า
หมวดหมู่การอัปเดต
การอัปเดตในบันทึกการเปลี่ยนแปลงนี้จัดหมวดหมู่เป็น:
- 🚀 Feature - ฟังก์ชันการทำงานหรือความสามารถใหม่
- ⚡ Enhancement - การปรับปรุงฟีเจอร์ที่มีอยู่เดิม
- 🐛 Fix - การแก้ไขจุดบกพร่องและข้อผิดพลาด
- 🔧 Maintenance - การอัปเดตโครงสร้างพื้นฐานและประสิทธิภาพ
- 📚 Documentation - การอัปเดตและการเพิ่มเอกสารประกอบ
- ⚠️ Breaking Change - การเปลี่ยนแปลงที่อาจต้องมีการอัปเดตโค้ด
สำหรับคำถามเกี่ยวกับการอัปเดตเฉพาะหรือการสนับสนุนด้านการผสานรวมระบบ โปรดติดต่อทีมเทคนิคของเราหรืออ้างอิงจากเอกสารประกอบ API