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+ महीने फुल प्रोडक्शन सपोर्ट
30 सेकंड में अपना API key प्राप्त करें

बिल्ड करने के लिए तैयार? एक मुफ़्त API key (100 कॉल/दिन, कोई कार्ड नहीं) लें और लाइव व्हेल, फंडिंग और ऑन-चेन डेटा पुल करना शुरू करें।

अपना API key प्राप्त करें →

बैकवर्ड कम्पेटिबिलिटी

वर्ज़न कम्पेटिबिलिटी

एक मेजर वर्ज़न के भीतर, आप हमेशा नए माइनर/पैच वर्ज़न पर सुरक्षित रूप से अपग्रेड कर सकते हैं:

  • एंडपॉइंट 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 keys अभी भी काम करती हैं)
  • रेट लिमिटिंग — इम्प्रूव्ड ग्रैन्युलैरिटी और क्लैरिटी
  • वेबहुक्स — रिडिज़ाइन्ड इवेंट फॉर्मेट और साइनिंग

एंडपॉइंट मैपिंग

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 only auth Mar 2026 Mar 2027 OAuth 2.0 (keys still work)
Webhook v1 format Q2 2026 Q2 2027 Webhook v2 format

ब्रेकिंग चेंजेस विवरण

हटाए गए एंडपॉइंट्स

  • /v1/stats — /v2/metrics द्वारा प्रतिस्थापित
  • /v1/historical — नए पैरामीटर्स के साथ /v2/historical द्वारा प्रतिस्थापित
  • /v1/alerts/create — POST /v2/alerts द्वारा प्रतिस्थापित

पैरामीटर परिवर्तन

  • limit — डिफ़ॉल्ट 100 से 20 पर बदला गया (स्पष्ट रहें!)
  • timeframe — अब ऐतिहासिक क्वेरीज़ पर आवश्यक
  • sort — प्रारूप "field asc" से "field:asc" में बदला गया

प्रतिक्रिया फील्ड परिवर्तन

  • fundingfunding_rate
  • pricemark_price
  • volvolume_quote

चरण-दर-चरण माइग्रेशन

चरण 1: योजना (सप्ताह 1-2)

  1. अप्रचलित फीचर्स के लिए मौजूदा इंटीग्रेशन का ऑडिट करें
  2. v1 एंडपॉइंट्स को v2 समकक्षों से मैप करें
  3. अपने कोड को प्रभावित करने वाले ब्रेकिंग चेंजेस की पहचान करें
  4. टेस्टिंग रणनीति और समयरेखा की योजना बनाएं

चरण 2: विकास (सप्ताह 3-4)

  1. वर्जन कंट्रोल में v2 ब्रांच बनाएं
  2. सभी API एंडपॉइंट्स को v2 URLs पर अपडेट करें
  3. अनुरोध/प्रतिक्रिया हैंडलिंग अपडेट करें
  4. सैंडबॉक्स के खिलाफ यूनिट टेस्ट चलाएं

चरण 3: टेस्टिंग (सप्ताह 5-6)

  1. पूर्ण इंटीग्रेशन टेस्ट सूट चलाएं
  2. त्रुटि परिदृश्यों और एज केसों का परीक्षण करें
  3. v2 एंडपॉइंट्स के साथ लोड टेस्टिंग
  4. अपडेटेड कोड का सुरक्षा ऑडिट

चरण 4: स्टेजिंग (सप्ताह 7)

  1. स्टेजिंग वातावरण में v2 कोड डिप्लॉय करें
  2. पूर्ण स्वीकृति परीक्षण चलाएं
  3. हितधारकों से साइन-ऑफ प्राप्त करें
  4. रोलबैक योजना तैयार करें

चरण 5: प्रोडक्शन (सप्ताह 8)

  1. प्रोडक्शन में ब्लू-ग्रीन डिप्लॉयमेंट
  2. मेट्रिक्स और त्रुटि दरों की निगरानी करें
  3. सपोर्ट मुद्दों के लिए ऑन-कॉल रहें
  4. धीरे-धीरे v1 कोड को डिकमिशन करें

सपोर्ट और संसाधन

उपलब्ध टूल्स

  • माइग्रेशन वैलिडेटर — अप्रचलित उपयोग के लिए कोड की जांच करें
  • API अपग्रेड चेकर — v1 और v2 संगतता की तुलना करें
  • माइग्रेशन चेकलिस्ट — कार्यों और समयरेखा के साथ PDF
  • कोड उदाहरण — माइग्रेशन से पहले/बाद के नमूने

मदद प्राप्त करें

  • ईमेल: [email protected]
  • डॉक्यूमेंटेशन: changelog-versioning.html देखें
  • डिस्कॉर्ड: कम्युनिटी सपोर्ट चैनल
  • एंटरप्राइज़: समर्पित माइग्रेशन इंजीनियर

अपना माइग्रेशन आज ही शुरू करें

व्यापक माइग्रेशन टूल्स, डॉक्यूमेंटेशन और सपोर्ट के साथ API v2 पर अपग्रेड करें। ज़ीरो-डाउनटाइम माइग्रेशन के लिए बनाया गया।

V2 एक्सप्लोर करें
V1 Jan 2028 तक सपोर्टेड। आज ही अपने माइग्रेशन की योजना बनाएं।

संबंधित संसाधन

मुफ्त शुरुआत — 100 कॉल/दिन, कोई कार्ड नहीं

एक API से 3 एक्सचेंजों पर लाइव व्हेल फ्लो, फंडिंग, ओपन इंटरेस्ट और ऑन-चेन डेटा प्राप्त करें। मुफ्त टियर, कोई क्रेडिट कार्ड नहीं, कभी भी अपग्रेड करें।

मुफ्त शुरुआत करें →
लाइव API कंसोल आज़माएं → (कोई खाता नहीं चाहिए)