Catatan Perubahan

Selamat datang di Catatan Perubahan Platform Netts — jurnal teknis komprehensif yang mendokumentasikan semua pembaruan, peningkatan, dan fitur baru yang diterapkan di seluruh ekosistem Netts.

Bagian ini menyediakan informasi terperinci mengenai:

• Peningkatan API dan endpoint baru
• Optimalisasi performa dan peningkatan infrastruktur
• Perbaikan bug dan pembaruan stabilitas
• Fitur baru dan penambahan fungsi
• Perubahan yang merusak (breaking changes) dan panduan migrasi

Semua entri didokumentasikan dalam format teknis profesional dengan detail implementasi, komponen yang terpengaruh, dan informasi versi.

---

Pembaruan Terkini

21 Januari 2026 - Batas Maksimum Pesanan Energy Dikurangi

Tipe: ⚠️ Breaking Change

Ringkasan: Mengurangi jumlah maksimum energy per pesanan dari 5.000.000 menjadi 3.000.000 unit.

Detail:

• Maksimum energy per pesanan tunggal: 5.000.000 → 3.000.000
• Minimum energy tetap tidak berubah: 61.000
• Pengguna yang membutuhkan lebih dari 3 juta energy harus membaginya ke dalam beberapa pesanan

Komponen yang Terpengaruh:

• API: Validasi endpoint /apiv2/order1h
• Dokumentasi: Order 1h

---

3 Desember 2025 - Endpoint Pemeriksaan Pesanan Baru

Tipe: Fitur

Ringkasan: Menambahkan endpoint API baru /apiv2/order_check untuk mengambil informasi terperinci tentang pesanan energy 1 jam.

Detail:

• Dapatkan detail pesanan termasuk biaya, jumlah energy, alamat tujuan, dan hash transaksi
• Lihat informasi aktivasi jika alamat diaktifkan
• Pengguna induk (parent) dapat melihat rincian markup sub-pengguna (energy_markup, activation_markup, net_cost)
• Mendukung validasi kepemilikan dan kontrol akses induk-sub-pengguna

Komponen yang Terpengaruh:

• API: Endpoint /apiv2/order_check baru
• Dokumentasi: Pemeriksaan Pesanan

---

3 Desember 2025 - Peningkatan Kode Status HTTP Idempotensi & Optimalisasi Performa

Tipe: Peningkatan

Ringkasan: Memperbarui kode status HTTP untuk respons idempotensi guna memberikan umpan balik yang lebih jelas untuk permintaan duplikat. Selain itu, mengoptimalkan pemrosesan pool internal untuk waktu respons di bawah satu detik.

Detail:

Perubahan Kode Status HTTP:

• 208 Already Reported - Sekarang dikembalikan ketika permintaan duplikat diterima untuk pesanan yang sudah diproses (sebelumnya mengembalikan 200)
• 409 Conflict - Sekarang dikembalikan ketika permintaan duplikat tiba saat permintaan asli masih diproses (sebelumnya mengembalikan 200)
• Badan respons tetap tidak berubah - hanya kode status HTTP yang berbeda

Optimalisasi Performa:

• Pemrosesan pesanan pool internal kini selesai dalam waktu kurang dari 1 detik (termasuk aktivasi alamat)
• Waktu respons tipikal: 500-700 md untuk pesanan pool internal
• Fallback penyedia eksternal tetap mempertahankan karakteristik performa yang sudah ada

Mengapa Ini Penting:

• Pembedaan yang lebih jelas antara permintaan pertama yang berhasil (200) dan respons yang di-cache/duplikat (208/409)
• Klien kini dapat dengan mudah mendeteksi respons duplikat dengan memeriksa kode status HTTP
• Mencegah kebingungan saat menerima 200 OK untuk permintaan yang sudah diproses
• Peningkatan kecepatan pemrosesan untuk pengalaman pengguna yang lebih baik

Komponen yang Terpengaruh:

• API: Endpoint /apiv2/order1h
• Modul penanganan idempotensi
• Pemrosesan pesanan pool internal

---

19 November 2025 - Peningkatan Perhitungan Saldo di API dan Situs Web

Tipe: ⚡ Peningkatan

Ringkasan: Memperbarui logika perhitungan saldo pada endpoint API /apiv2/userinfo dan bagian Dompet di situs web untuk menampilkan Total Saldo TRX yang mencakup semua transaksi yang tertunda.

Detail:

Perubahan API (/apiv2/userinfo):

• Bidang balance dalam respons API kini mengembalikan Total Saldo TRX, bukan hanya saldo deposit
• Total Saldo TRX mencakup:
  • Saldo dompet deposit
  • Pembayaran tertunda (Robot & Sub-pengguna)
  • Dikurangi penarikan yang tertunda

Perubahan Situs Web (Bagian Dompet):

• Tampilan saldo diperbarui untuk menampilkan Total Saldo TRX dari API
• Logika frontend disederhanakan - kalkulasi duplikat dihapus
• Menambahkan tooltip informatif yang menjelaskan komponen saldo

Penting:

• TRX pembayaran Robot & Sub-pengguna dikreditkan ke alamat deposit 2 kali per hari
• Sebelum dikreditkan, TRX pembayaran Robot & Sub-pengguna tidak dapat digunakan untuk pembelian energy
• Untuk menarik TRX/USDT pembayaran Robot & Sub-pengguna, centang kotak centang pada formulir penarikan

Komponen yang Terpengaruh:

• API: Endpoint /apiv2/userinfo
• Situs Web: Halaman Dompet (Deposit & Penarikan)
• Backend: Logika perhitungan saldo

---

19 November 2025 - Inisialisasi Catatan Perubahan

Tipe: 📚 Dokumentasi

Ringkasan: Pembuatan awal Catatan Perubahan Platform Netts. Ini menandai dimulainya jurnal teknis publik kami tempat kami akan mendokumentasikan semua perubahan signifikan, peningkatan, dan fitur baru.

Detail:

• Menetapkan struktur catatan perubahan dan format dokumentasi
• Membuat bagian khusus di situs dokumentasi
• Menerapkan sistem pelacakan pembaruan berversi

Tujuan: Untuk memberikan transparansi dan komunikasi yang jelas mengenai evolusi platform kepada pengguna, pengembang, dan mitra integrasi kami.

---

Arsip

Pembaruan sebelumnya akan dicantumkan di sini seiring berjalannya waktu, disusun berdasarkan tanggal dalam urutan kronologis terbalik.

---

Kategori Pembaruan

Pembaruan dalam catatan perubahan ini dikategorikan sebagai:

• 🚀 Fitur - Fungsionalitas atau kapabilitas baru
• ⚡ Peningkatan - Peningkatan pada fitur yang sudah ada
• 🐛 Perbaikan - Perbaikan bug dan koreksi kesalahan
• 🔧 Pemeliharaan - Pembaruan infrastruktur dan performa
• 📚 Dokumentasi - Pembaruan dan penambahan dokumentasi
• ⚠️ Perubahan yang Merusak - Perubahan yang mungkin memerlukan pembaruan kode

---

Untuk pertanyaan tentang pembaruan tertentu atau dukungan integrasi, silakan hubungi tim teknis kami atau lihat dokumentasi API.