فہرست

جائزہ ورژننگ پالیسی پیچھے کی مطابقت V1 سے V2 مائگریشن اینڈ پوائنٹ تبدیلیاں جوابی فارمیٹ اپ ڈیٹس متروکہ ٹائم لائن توڑنے والی تبدیلیاں قدم بہ قدم مائگریشن سپورٹ اور وسائل

API دستاویزات

API مائگریشن گائیڈ — ورژنز کے درمیان اپ گریڈ

API ورژن اپ گریڈز کو منصوبہ بندی اور ہموار طریقے سے انجام دیں۔ توڑنے والی تبدیلیوں، متروکہ ٹائم لائنز، اور Smart Money API ورژنز کے درمیان منتقلی کے بہترین طریقوں کو سمجھیں۔

21 مارچ 2026 کو شائع ہوا • 16 منٹ پڑھنے کا وقت • ایڈوانسڈ

مائگریشن کا جائزہ

Smart Money API کو باقاعدہ اپ ڈیٹس کے ساتھ فعال طور پر تیار کیا جاتا ہے۔ یہ گائیڈ ورژن مینجمنٹ، توڑنے والی تبدیلیوں، اور صفر ڈاؤن ٹائم کے ساتھ اپنے انٹیگریشن کو منتقل کرنے کے طریقوں کا احاطہ کرتی ہے۔

مائگریشن کے اہم اصول:

سیمانٹک ورژننگ — MAJOR.MINOR.PATCH فارمیٹ سختی سے اپنایا گیا
طویل مدتی سپورٹ — پچھلے میجر ورژن کو 24+ ماہ تک سپورٹ کیا جاتا ہے
متروکہ انتباہات — تمام توڑنے والی تبدیلیوں پر 6 ماہ پہلے نوٹس
متوازی ورژنز — مائگریشن کے دوران v1 اور v2 کو بیک وقت چلائیں
آٹومیٹڈ ٹیسٹنگ — ٹیسٹ سوٹ کی مطابقت کے ٹولز فراہم کیے گئے ہیں

موجودہ حیثیت: v1 (موجودہ)، v2 (بیٹا، جنرل دستیابی Q2 2026)۔ v1 کو Q1 2028 تک سپورٹ کیا جائے گا۔

ورژننگ پالیسی

سیمانٹک ورژننگ

ورژن فارمیٹ
API ورژن: MAJOR.MINOR.PATCH
مثال: 2.1.3
MAJOR (2) - توڑنے والی تبدیلیاں، نیا آرکیٹیکچر
MINOR (1) - پیچھے کی مطابقت والی خصوصیات
PATCH (3) - بگ فکسز، سیکورٹی اپ ڈیٹس

ورژن رلیز سائیکل

مرحلہ	دورانیہ	خصوصیات
الفا	2-4 ہفتے	زیادہ توڑنے والی تبدیلیاں، صرف ٹیسٹنگ
بیٹا	4-8 ہفتے	زیادہ تر مستحکم، کمیونٹی فیڈ بیک
رلیز امیدوار	2-4 ہفتے	پروڈکشن کے لیے تیار، آخری پالش
جنرل دستیابی	24+ ماہ	مکمل پروڈکشن سپورٹ

اپنا API کلید 30 سیکنڈ میں حاصل کریں

تعمیر کے لیے تیار ہیں؟ ایک مفت API کلید حاصل کریں (100 کالز/دن، کوئی کارڈ نہیں) اور لائیو وہیل، فنڈنگ اور آن چین ڈیٹا نکالنا شروع کریں۔

اپنا API کلید حاصل کریں →

پیچھے کی مطابقت

ورژن مطابقت

ایک میجر ورژن کے اندر، آپ ہمیشہ نئے مائنر/پیچ ورژنز پر محفوظ طریقے سے اپ گریڈ کر سکتے ہیں:

اینڈ پوائنٹ URLs — تبدیل نہیں ہوتے
ضروری فیلڈز — کبھی نہیں ہٹائے جاتے (صرف نئے اختیاری فیلڈز شامل کیے جاتے ہیں)
HTTP سٹیٹس کوڈز — موجودہ منظرناموں کے لیے محفوظ
جوابی ڈھانچہ — بنیادی فیلڈز یکساں رہتے ہیں
تصدیق کاری — تصدیق کے طریقہ کار میں کوئی تبدیلی نہیں

نرمی سے متروکہ

متروکہ ٹائم لائن
// مہینہ 1: متروکہ کا اعلان
// خصوصیت کو Deprecation ہیڈر کے ساتھ نشان زد کیا گیا
Deprecation: version="2.2", sunset="2026-09-01"
// مہینہ 3-6: فعال متروکہ دور
// API انتباہات واپس کرتا ہے لیکن اب بھی کام کرتا ہے
X-Deprecation-Warning: یہ اینڈ پوائنٹ 2026-09-01 کو ہٹا دیا جائے گا
// مہینہ 6: آخری ہٹانا
// اینڈ پوائنٹ 410 Gone واپس کرتا ہے
HTTP/1.1 410 Gone

V1 سے V2 مائگریشن

اہم تبدیلیاں

REST API ری ڈیزائن — صاف تر وسائل اینڈ پوائنٹس
جوابی فارمیٹ — مستقل لپیٹنا، بہتر غلطی ہینڈلنگ
تصدیق کاری — OAuth 2.0 سپورٹ شامل (API کلیدز اب بھی کام کرتی ہیں)
ریٹ لیمٹنگ — بہتر گرانولیرٹی اور وضاحت
ویب ہکس — دوبارہ ڈیزائن کردہ ایونٹ فارمیٹ اور دستخط

اینڈ پوائنٹ میپنگ

v1 اینڈ پوائنٹ	v2 اینڈ پوائنٹ	تبدیلیاں
GET /whales	GET /v2/whales/tracking	دوبارہ منظم، فلٹرنگ شامل
GET /funding	GET /v2/derivatives/funding-heatmap	ایکسچینج پیرامیٹر ضروری
GET /positions	GET /v2/derivatives/positions	نئے مجموعی اختیارات

اینڈ پوائنٹ تبدیلیاں

درخواست پیرامیٹر تبدیلیاں

V1 درخواست
// V1: فنڈنگ ریٹس
GET /v1/funding?symbol=BTCUSDT&exchange=binance

V2 درخواست
// V2: وہی ڈیٹا، واضح ڈھانچہ
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

جوابی فارمیٹ اپ ڈیٹس

V1 رسپانس ڈھانچہ

V1 فارمیٹ
{
 "status": "success",
 "data": {
 "symbol": "BTCUSDT",
 "funding": 0.0001
  }
}

V2 رسپانس ڈھانچہ

V2 فارمیٹ
{
 "data": {
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001
  },
 "_meta": {
 "request_id": "req_abc123",
 "timestamp": 1709980800000
  }
}

کلیدی فرق: کوئی اسٹیٹس ریپر نہیں، واضح فیلڈ نام، معیاری میٹا ڈیٹا۔

ڈیپریکیشن ٹائم لائن

منصوبہ بند ڈیپریکیشنز

فیچر	اعلان کردہ	سان سیٹ تاریخ	متبادل
/v1/whales	Jan 2026	Jan 2028	/v2/whales/tracking
/v1/funding	Jan 2026	Jan 2028	/v2/derivatives/funding-heatmap
API key صرف تصدیق	Mar 2026	Mar 2027	OAuth 2.0 (کیز اب بھی کام کرتی ہیں)
ویب ہک v1 فارمیٹ	Q2 2026	Q2 2027	ویب ہک v2 فارمیٹ

بریکنگ تبدیلیوں کی تفصیل

ہٹائے گئے اینڈ پوائنٹس

/v1/stats — /v2/metrics سے تبدیل کردیا گیا
/v1/historical — نئے پیرامیٹرز کے ساتھ /v2/historical سے تبدیل کردیا گیا
/v1/alerts/create — POST /v2/alerts سے تبدیل کردیا گیا

پیرامیٹر تبدیلیاں

limit — ڈیفالٹ 100 سے 20 پر تبدیل کردیا گیا (واضح رہیں!)
timeframe — اب تاریخی کوریز پر ضروری ہے
sort — فارمیٹ "field asc" سے "field:asc" پر تبدیل کردیا گیا

رسپانس فیلڈ تبدیلیاں

funding → funding_rate
price → mark_price
vol → volume_quote

مرحلہ وار مائیگریشن

فیز 1: منصوبہ بندی (ہفتہ 1-2)

ڈیپریکیٹڈ فیچرز کے لیے موجودہ انٹیگریشن کا آڈٹ کریں
v1 اینڈ پوائنٹس کو v2 کے مساوی سے میپ کریں
اپنے کوڈ کو متاثر کرنے والی بریکنگ تبدیلیوں کی نشاندہی کریں
ٹیسٹنگ اسٹریٹیجی اور ٹائم لائن کی منصوبہ بندی کریں

فیز 2: ڈویلپمنٹ (ہفتہ 3-4)

ورژن کنٹرول میں v2 برانچ بنائیں
تمام API اینڈ پوائنٹس کو v2 URLs پر اپ ڈیٹ کریں
درخواست/رسپانس ہینڈلنگ کو اپ ڈیٹ کریں
سینڈ باکس کے خلاف یونٹ ٹیسٹ چلائیں

فیز 3: ٹیسٹنگ (ہفتہ 5-6)

مکمل انٹیگریشن ٹیسٹ سوٹ چلائیں
ایرر سیناریوز اور ایج کیسز کو ٹیسٹ کریں
v2 اینڈ پوائنٹس کے ساتھ لوڈ ٹیسٹنگ کریں
اپ ڈیٹ کردہ کوڈ کا سیکورٹی آڈٹ کریں

فیز 4: اسٹیجنگ (ہفتہ 7)

v2 کوڈ کو اسٹیجنگ ماحول میں ڈیپلائی کریں
مکمل ایکسیپٹنس ٹیسٹ چلائیں
اسٹیک ہولڈرز سے سائن آف حاصل کریں
رول بیک پلان تیار کریں

فیز 5: پروڈکشن (ہفتہ 8)

بلیو-گرین ڈپلائی کو پروڈکشن میں کریں
میٹرکس اور ایرر ریٹس کو مانیٹر کریں
سپورٹ مسائل کے لیے کال پر رہیں
آہستہ آہستہ v1 کوڈ کو ڈی کمیشن کریں

سپورٹ اور وسائل

دستیاب ٹولز

مائیگریشن والیڈیٹر — ڈیپریکیٹڈ استعمال کے لیے کوڈ چیک کریں
API اپ گریڈ چیکر — v1 اور v2 کی مطابقت کا موازنہ کریں
مائیگریشن چیک لسٹ — ٹاسکس اور ٹائم لائن کے ساتھ PDF
کوڈ مثالیں — مائیگریشن سے پہلے/بعد کے نمونے

مدد حاصل کریں

ای میل: [email protected]
دستاویزات: changelog-versioning.html دیکھیں
ڈسکارڈ: کمیونٹی سپورٹ چینل
انٹرپرائز: مخصوص مائیگریشن انجینئر

اپنی مائیگریشن آج شروع کریں

API v2 پر جامع مائیگریشن ٹولز، دستاویزات، اور سپورٹ کے ساتھ اپ گریڈ کریں۔ زیرو-ڈاؤن ٹائم مائیگریشن کو سپورٹ کرنے کے لیے بنایا گیا۔

V2 دریافت کریں

V1 جنوری 2028 تک سپورٹ شدہ۔ اپنی مائیگریشن کی منصوبہ بندی آج کریں۔