تبدیلیوں کا لاگ (Changelog)
Netts Platform Changelog میں خوش آمدید — ایک جامع تکنیکی جریدہ جو Netts کے پورے ایکو سسٹم میں لاگو ہونے والی تمام اپ ڈیٹس، بہتریوں اور نئی خصوصیات کی دستاویز بندی کرتا ہے۔
یہ سیکشن درج ذیل کے بارے میں تفصیلی معلومات فراہم کرتا ہے:
- API میں بہتری اور نئے اینڈ پوائنٹس
- کارکردگی میں اضافہ (Performance optimizations) اور انفراسٹرکچر کی بہتری
- بگز کا حل (Bug fixes) اور استحکام سے متعلق اپ ڈیٹس
- نئی خصوصیات اور فنکشنلٹی کا اضافہ
- بریکنگ تبدیلیاں (Breaking changes) اور مائیگریشن گائیڈز
تمام اندراجات تکنیکی اعتبار سے پیشہ ورانہ انداز میں نفاذ کی تفصیلات، متاثرہ اجزاء، اور ورژن کی معلومات کے ساتھ دستاویز کیے گئے ہیں۔
تازہ ترین اپ ڈیٹس
21 جنوری، 2026 - Maximum Energy Order Limit میں کمی
قسم: ⚠️ Breaking Change
خلاصہ: فی آرڈر زیادہ سے زیادہ Energy کی حد 5,000,000 سے کم کر کے 3,000,000 یونٹس کر دی گئی ہے۔
تفصیلات:
- ایک آرڈر میں زیادہ سے زیادہ Energy: 5,000,000 ← 3,000,000
- کم سے کم Energy بغیر کسی تبدیلی کے برقرار ہے: 61,000
- ایسے صارفین جنہیں 3M سے زیادہ Energy درکار ہو، وہ اسے متعدد آرڈرز میں تقسیم کریں
متاثرہ اجزاء:
- API:
/apiv2/order1hاینڈ پوائنٹ کی توثیق (validation) - دستاویزات: Order 1h
3 دسمبر، 2025 - نیا Order Check اینڈ پوائنٹ
قسم: Feature
خلاصہ: 1 گھنٹے کے Energy آرڈرز کے بارے میں تفصیلی معلومات حاصل کرنے کے لیے نیا API اینڈ پوائنٹ /apiv2/order_check شامل کیا گیا ہے۔
تفصیلات:
- آرڈر کی تفصیلات بشمول لاگت، Energy کی مقدار، ہدف ایڈریس، اور ٹرانزیکشن ہیشز حاصل کریں
- اگر ایڈریس فعال (activate) کیا گیا تھا تو ایکٹیویشن کی معلومات دیکھیں
- پیرنٹ صارفین سب یوزر کے مارک اپ کی تفصیلات (energy_markup، activation_markup، net_cost) دیکھ سکتے ہیں
- ملکیت کی توثیق (ownership validation) اور پیرنٹ-سب یوزر رسائی کنٹرول کو سپورٹ کرتا ہے
متاثرہ اجزاء:
- API: نیا
/apiv2/order_checkاینڈ پوائنٹ - دستاویزات: Order Check
3 دسمبر، 2025 - Idempotency HTTP Status Codes میں بہتری اور کارکردگی کی بہٹری
قسم: Enhancement
خلاصہ: ڈپلیکیٹ درخواستوں پر واضح فیڈ بیک فراہم کرنے کے لیے Idempotency کے رسپانسز کے HTTP اسٹیٹس کوڈز کو اپ ڈیٹ کیا گیا ہے۔ اس کے علاوہ، ایک سیکنڈ سے بھی کم وقت میں رسپانس دینے کے لیے اندرونی پول پروسیسنگ کو بہتر بنایا گیا ہے۔
تفصیلات:
HTTP Status Code میں تبدیلیاں:
- 208 Already Reported - اب یہ اس وقت ریٹرن ہوتا ہے جب پہلے سے پروسیس شدہ آرڈر کے لیے ڈپلیکیٹ درخواست موصول ہوتی ہے (پہلے 200 ریٹرن ہوتا تھا)
- 409 Conflict - اب یہ اس وقت ریٹرن ہوتا ہے جب اصل درخواست کی پروسیسنگ کے دوران ہی ڈپلیکیٹ درخواست موصول ہو جاتی ہے (پہلے 200 ریٹرن ہوتا تھا)
- رسپانس باڈی بغیر کسی تبدیلی کے برقرار ہے - صرف HTTP اسٹیٹس کوڈ تبدیل ہوا ہے
کارکردگی میں بہتری:
- اندرونی پول آرڈر پروسیسنگ اب 1 سیکنڈ سے کم وقت میں مکمل ہوتی ہے (بشمول ایڈریس ایکٹیویشن)
- اندرونی پول آرڈرز کے لیے عمومی رسپانس کا وقت: 500-700ms
- بیرونی فراہم کنندہ کا فال بیک اپنی موجودہ کارکردگی کی خصوصیات کو برقرار رکھتا ہے
یہ کیوں اہم ہے:
- پہلی کامیاب درخواستوں (200) اور کیشڈ/ڈپلیکیٹ رسپانسز (208/409) کے درمیان واضح فرق
- کلائنٹس اب آسانی سے HTTP اسٹیٹس کوڈ چیک کر کے ڈپلیکیٹ رسپانسز کا پتہ لگا سکتے ہیں
- پہلے سے پروسیس شدہ درخواستوں کے لیے 200 OK موصول ہونے پر پیدا ہونے والے ابہام سے بچاؤ
- بہتر صارف کے تجربے کے لیے پروسیسنگ کی رفتار میں اضافہ
متاثرہ اجزاء:
- API:
/apiv2/order1hاینڈ پوائنٹ - Idempotency ہینڈلنگ ماڈیول
- اندرونی پول آرڈر پروسیسنگ
19 نومبر، 2025 - API اور ویب سائٹ میں بیلنس کے حساب کتاب میں بہتری
قسم: ⚡ Enhancement
خلاصہ: API اینڈ پوائنٹ /apiv2/userinfo اور ویب سائٹ کے Wallet سیکشن میں بیلنس کیلکولیشن لاجک کو اپ ڈیٹ کر دیا گیا ہے تاکہ تمام زیر التواء ٹرانزیکشنز پر مشتمل Total Balance TRX دکھایا جا سکے۔
تفصیلات:
API کی تبدیلیاں (/apiv2/userinfo):
- API کے رسپانس میں
balanceفیلڈ اب محض ڈیپازٹ بیلنس کے بجائے Total Balance TRX ریٹرن کرتی ہے - Total Balance TRX میں درج ذیل شامل ہیں:
- ڈیپازٹ والیٹ بیلنس
- زیر التواء پے آؤٹس (Robot اور Sub-users)
- منہا کی گئی زیر التواء رقم نکلوانا (withdrawals)
ویب سائٹ کی تبدیلیاں (Wallet سیکشن):
- API سے حاصل کردہ Total Balance TRX دکھانے کے لیے بیلنس ڈسپلے کو اپ ڈیٹ کیا گیا ہے
- فرنٹ اینڈ لاجک کو آسان بنایا گیا ہے - ڈپلیکیٹ حساب کتاب کو ہٹا دیا گیا ہے
- بیلنس کے اجزاء کی وضاحت کرنے والا ایک معلوماتی ٹول ٹپ شامل کیا گیا ہے
اہم:
- Robot اور Sub-users کے پے آؤٹ TRX ڈیپازٹ ایڈریس پر روزانہ 2 بار کریڈٹ کیے جاتے ہیں
- کریڈٹ ہونے سے پہلے، Robot اور Sub-users کے پے آؤٹ TRX کو Energy کی خریداری کے لیے استعمال نہیں کیا جا سکتا
- Robot اور Sub-users کے پے آؤٹ TRX/USDT کو نکالنے کے لیے، نکلوانے کے فارم میں چیک باکس کو فعال کریں
متاثرہ اجزاء:
- API:
/apiv2/userinfoاینڈ پوائنٹ - ویب سائٹ: Wallet (Deposit & Withdraw) صفحہ
- بیک اینڈ: بیلنس کیلکولیشن لاجک
19 نومبر، 2025 - تبدیلیوں کے لاگ کا آغاز
قسم: 📚 Documentation
خلاصہ: Netts Platform Changelog کا ابتدائی اجراء۔ یہ ہمارے عوامی تکنیکی جریدے کا آغاز ہے جہاں ہم تمام اہم تبدیلیوں، بہتریوں، اور نئی خصوصیات کو دستاویز کریں گے۔
تفصیلات:
- چینج لاگ کے ڈھانچے اور دستاویزاتی فارمیٹ کا قیام
- دستاویزاتی سائٹ میں مخصوص سیکشن تیار کیا گیا
- ورژن پر مبنی اپ ڈیٹ ٹریکنگ سسٹم لاگو کیا گیا
مقصد: اپنے صارفین، ڈویلپرز اور انضمام کے شراکت داروں (integration partners) کو پلیٹ فارم کے ارتقاء کے بارے میں شفافیت اور واضح مواصلت فراہم کرنا۔
محفوظات (Archive)
سابقہ اپ ڈیٹس کے واقع ہونے کے ساتھ ہی انہیں یہاں تاریخ کے الٹے تاریخی اعتبار (reverse chronological order) سے درج کیا جائے گا۔
اپ ڈیٹ کے زمرہ جات
اس چینج لاگ میں اپ ڈیٹس کو مندرجہ ذیل زمروں میں تقسیم کیا گیا ہے:
- 🚀 Feature - نئی فنکشنلٹی یا صلاحیتیں
- ⚡ Enhancement - موجودہ خصوصیات میں بہتری
- 🐛 Fix - بگز کا حل اور غلطیوں کی درستی
- 🔧 Maintenance - انفراسٹرکچر اور کارکردگی کی اپ ڈیٹس
- 📚 Documentation - دستاویزات کی اپ ڈیٹس اور نئے اضافے
- ⚠️ Breaking Change - وہ تبدیلیاں جن کے لیے کوڈ کو اپ ڈیٹ کرنے کی ضرورت ہو سکتی ہے
مخصوص اپ ڈیٹس سے متعلق سوالات یا انضمام کی معاونت کے لیے، براہ کرم ہماری تکنیکی ٹیم سے رابطہ کریں یا API دستاویزات سے رجوع کریں۔