Değişiklik Günlüğü

Netts ekosistemi genelinde uygulanan tüm güncellemeleri, iyileştirmeleri ve yeni özellikleri belgeleyen kapsamlı bir teknik bülten olan Netts Platform Değişiklik Günlüğü'ne hoş geldiniz.

Bu bölüm şu konular hakkında ayrıntılı bilgi sağlar:

• API geliştirmeleri ve yeni uç noktalar
• Performans optimizasyonları ve altyapı iyileştirmeleri
• Hata düzeltmeleri ve kararlılık güncellemeleri
• Yeni özellikler ve işlevsellik eklemeleri
• Önemli değişiklikler (breaking changes) ve geçiş kılavuzları

Tüm kayıtlar; uygulama ayrıntıları, etkilenen bileşenler ve sürüm bilgileriyle birlikte profesyonel bir teknik formatta belgelenmiştir.

---

En Son Güncellemeler

21 Ocak 2026 - Maksimum Energy Sipariş Limiti Düşürüldü

Tür: ⚠️ Önemli Değişiklik

Özet: Sipariş başına maksimum Energy miktarı 5.000.000 birimden 3.000.000 birime düşürüldü.

Ayrıntılar:

• Tek sipariş başına maksimum Energy: 5.000.000 → 3.000.000
• Minimum Energy değişmedi: 61.000
• 3 milyondan fazla Energy gereksinimi olan kullanıcılar siparişlerini birden fazla işleme bölmelidir

Etkilenen Bileşenler:

• API: /apiv2/order1h uç noktası doğrulaması
• Dokümantasyon: Order 1h

---

3 Aralık 2025 - Yeni Sipariş Kontrol Uç Noktası

Tür: Özellik

Özet: 1 saatlik Energy siparişleri hakkında ayrıntılı bilgi almak için yeni /apiv2/order_check API uç noktası eklendi.

Ayrıntılar:

• Maliyet, Energy miktarı, hedef adres ve işlem özetleri (transaction hashes) dahil sipariş ayrıntılarını alma
• Adres etkinleştirildiyse etkinleştirme bilgilerini görüntüleme
• Üst kullanıcılar alt kullanıcı kâr marjı dökümünü (energy_markup, activation_markup, net_cost) görebilir
• Sahiplik doğrulamasını ve üst-alt kullanıcı erişim kontrolünü destekler

Etkilenen Bileşenler:

• API: Yeni /apiv2/order_check uç noktası
• Dokümantasyon: Order Check

---

3 Aralık 2025 - İyileştirilmiş Eşgüçlülük (Idempotency) HTTP Durum Kodları ve Performans Optimizasyonu

Tür: İyileştirme

Özet: Yinelenen isteklerde daha net geri bildirim sağlamak için eşgüçlülük yanıtlarının HTTP durum kodları güncellendi. Ayrıca, saniyenin altında yanıt süreleri için dahili havuz işleme mekanizması optimize edildi.

Ayrıntılar:

HTTP Durum Kodu Değişiklikleri:

• 208 Already Reported - Artık önceden işlenmiş bir sipariş için yinelenen bir istek alındığında döndürülür (önceden 200 dönüyordu)
• 409 Conflict - Artık orijinal istek hâlâ işlenirken yinelenen bir istek geldiğinde döndürülür (önceden 200 dönüyordu)
• Yanıt gövdesi değişmedi; yalnızca HTTP durum kodu farklıdır

Performans Optimizasyonu:

• Dahili havuz sipariş işlemleri artık 1 saniyenin altında tamamlanıyor (adres etkinleştirmesi dahil)
• Tipik yanıt süresi: Dahili havuz siparişleri için 500-700 ms
• Harici sağlayıcı yedekleme mekanizması (fallback) mevcut performans niteliklerini korur

Neden Önemli:

• Başarılı ilk istekler (200) ile önbelleğe alınmış/yinelenen yanıtlar (208/409) arasında daha net ayrım
• İstemciler artık HTTP durum kodunu kontrol ederek yinelenen yanıtları kolayca tespit edebilir
• Zaten işlenmiş olan istekler için 200 OK alındığında oluşan kafa karışıklığını önler
• Daha iyi bir kullanıcı deneyimi için artırılmış işlem hızı

Etkilenen Bileşenler:

• API: /apiv2/order1h uç noktası
• Eşgüçlülük (Idempotency) işleme modülü
• Dahili havuz sipariş işleme

---

19 Kasım 2025 - API ve Web Sitesinde Gelişmiş Bakiye Hesaplaması

Tür: ⚡ İyileştirme

Özet:/apiv2/userinfo API uç noktasındaki ve web sitesi Cüzdan bölümündeki bakiye hesaplama mantığı, bekleyen tüm işlemleri içeren Toplam TRX Bakiyesini gösterecek şekilde güncellendi.

Ayrıntılar:

API Değişiklikleri (/apiv2/userinfo):

• API yanıtındaki balance alanı artık yalnızca yatırma bakiyesi yerine Toplam TRX Bakiyesini döndürür
• Toplam TRX Bakiyesi şunları içerir:
  • Yatırma cüzdanı bakiyesi
  • Bekleyen ödemeler (Robot ve Alt kullanıcılar)
  • Eksi bekleyen çekimler

Web Sitesi Değişiklikleri (Cüzdan Bölümü):

• Bakiye ekranı, API'den gelen Toplam TRX Bakiyesini gösterecek şekilde güncellendi
• Ön uç mantığı basitleştirildi; yinelenen hesaplamalar kaldırıldı
• Bakiye bileşenlerini açıklayan bilgilendirici ipucu eklendi

Önemli:

• Robot ve Alt kullanıcı ödeme TRX tutarları, yatırma adresine günde 2 kez aktarılır
• Aktarılmadan önce Robot ve Alt kullanıcı ödeme TRX tutarları, Energy alımları için kullanılamaz
• Robot ve Alt kullanıcı ödeme TRX/USDT tutarlarını çekmek için çekim formundaki onay kutusunu işaretleyin

Etkilenen Bileşenler:

• API: /apiv2/userinfo uç noktası
• Web sitesi: Cüzdan (Yatırma ve Çekme) sayfası
• Arka uç: Bakiye hesaplama mantığı

---

19 Kasım 2025 - Değişiklik Günlüğünün Başlatılması

Tür: 📚 Dokümantasyon

Özet: Netts Platform Değişiklik Günlüğünün ilk oluşturulması. Bu, tüm önemli değişiklikleri, iyileştirmeleri ve yeni özellikleri belgeleyeceğimiz herkese açık teknik bültenimizin başlangıcını işaret eder.

Ayrıntılar:

• Değişiklik günlüğü yapısı ve dokümantasyon formatı belirlendi
• Dokümantasyon sitesinde özel bir bölüm oluşturuldu
• Sürümlendirilmiş güncelleme takip sistemi uygulandı

Amaç: Kullanıcılarımıza, geliştiricilerimize ve entegrasyon ortaklarımıza platformun gelişimi hakkında şeffaflık ve net iletişim sağlamak.

---

Arşiv

Önceki güncellemeler gerçekleştikçe burada, sondan başa doğru kronolojik sırayla listelenecektir.

---

Güncelleme Kategorileri

Bu değişiklik günlüğündeki güncellemeler şu şekilde kategorize edilir:

• 🚀 Özellik - Yeni işlevsellik veya kabiliyetler
• ⚡ İyileştirme - Mevcut özelliklerde yapılan iyileştirmeler
• 🐛 Düzeltme - Hata düzeltmeleri ve hata gidermeleri
• 🔧 Bakım - Altyapı ve performans güncellemeleri
• 📚 Dokümantasyon - Dokümantasyon güncellemeleri ve eklemeleri
• ⚠️ Önemli Değişiklik - Kod güncellemeleri gerektirebilecek değişiklikler

---

Belirli güncellemelerle ilgili sorularınız veya entegrasyon desteği için lütfen teknik ekibimizle iletişime geçin veya API dokümantasyonuna bakın.