API மைக்ரேஷன் வழிகாட்டி — பதிப்புகளுக்கு இடையே மேம்படுத்துதல்

ஸ்மார்ட் மனி API பதிப்புகளுக்கு இடையே மாற்றம் செய்வதற்கான முறிவு மாற்றங்கள், காலாவதி காலக்கெடு மற்றும் சிறந்த நடைமுறைகளைப் புரிந்துகொண்டு, மென்மையான API பதிப்பு மேம்பாடுகளைத் திட்டமிடுங்கள் மற்றும் செயல்படுத்துங்கள்.

மார்ச் 21, 2026 அன்று வெளியிடப்பட்டது 16 நிமிடம் வாசிப்பு மேம்பட்ட

மைக்ரேஷன் கண்ணோட்டம்

ஸ்மார்ட் மனி 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 வடிவம்
{
"நிலை": "வெற்றி",
"தரவு": {
"சின்னம்": "BTCUSDT",
"நிதியளிப்பு": 0.0001
}
}

V2 பதில் அமைப்பு

V2 வடிவம்
{
"தரவு": {
"சின்னம்": "BTCUSDT",
"நிதியளிப்பு விகிதம்": 0.0001
},
"_மெட்டா": {
"விண்ணப்ப ஐடி": "req_abc123",
"நேர முத்திரை": 1709980800000
}
}

முக்கிய வேறுபாடுகள்: நிலை மூடி இல்லை, தெளிவான புலப் பெயர்கள், தரப்படுத்தப்பட்ட மெட்டாடேட்டா.

காலாவதி காலவரிசை

திட்டமிடப்பட்ட காலாவதிகள்

அம்சம் அறிவிக்கப்பட்டது காலாவதி தேதி மாற்று
/v1/whales ஜன 2026 ஜன 2028 /v2/whales/tracking
/v1/funding ஜன 2026 ஜன 2028 /v2/derivatives/funding-heatmap
API விசை மட்டுமே அங்கீகாரம் மார் 2026 மார் 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" ஆக மாற்றப்பட்டது

பதில் புல மாற்றங்கள்

  • fundingfunding_rate
  • pricemark_price
  • volvolume_quote

படிப்படியான மாற்றம்

நிலை 1: திட்டமிடல் (வாரம் 1-2)

  1. காலாவதியான அம்சங்களுக்கான தற்போதைய ஒருங்கிணைப்பை தணிக்கை செய்யவும்
  2. v1 முனைகளை v2 சமமானவற்றுடன் வரைபடமாக்கவும்
  3. உங்கள் குறியீட்டை பாதிக்கும் முறிவு மாற்றங்களை அடையாளம் காணவும்
  4. சோதனை மூலோபாயம் மற்றும் காலவரிசையை திட்டமிடவும்

நிலை 2: மேம்பாடு (வாரம் 3-4)

  1. பதிப்பு கட்டுப்பாட்டில் v2 கிளையை உருவாக்கவும்
  2. அனைத்து API முனைகளையும் v2 URL களாக மேம்படுத்தவும்
  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 ஜன 2028 வரை ஆதரிக்கப்படுகிறது. உங்கள் மாற்றத்தை இன்றே திட்டமிடுங்கள்.

தொடர்புடைய வளங்கள்

இலவசமாக தொடங்குங்கள் — 100 அழைப்புகள்/நாள், கார்டு இல்லை

ஒரு API இலிருந்து 3 எக்ஸ்சேஞ்சுகளில் நேரடி திமிங்கல ஓட்டம், நிதியளிப்பு, திறந்த வட்டி மற்றும் சங்கிலி தரவைப் பெறுங்கள். இலவச டியர், கிரெடிட் கார்டு இல்லை, எப்போது வேண்டுமானாலும் மேம்படுத்தவும்.

இலவசமாக தொடங்குங்கள் →
நேரடி API கன்சோலை முயற்சிக்கவும் → (கணக்கு தேவையில்லை)