မာတိကာ

အခြေခံအကျဉ်း Versioning Policy Backward Compatibility V1 မှ V2 သို့ Migration Endpoint Changes Response Format Updates Deprecation Timeline Breaking Changes Step-by-Step Migration Support & Resources

API Documentation

API Migration Guide — Upgrading Between Versions

Smart Money API ဗားရှင်းများကြား အဆင်ပြေစွာပြောင်းလဲနိုင်ရန် စီမံဆောင်ရွက်ပါ။ Breaking changes၊ deprecation timelines နှင့် migration အတွက် အကောင်းဆုံးအလေ့အကျင့်များကို နားလည်ပါ။

March 21, 2026 တွင် ဖော်ပြခဲ့သည် • 16 min read • Advanced

Migration Overview

Smart Money API ကို ပုံမှန် update များဖြင့် တက်ကြွစွာ ဖွံ့ဖြိုးဆဲဖြစ်သည်။ ဤလမ်းညွှန်တွင် ဗားရှင်းစီမံခန့်ခွဲမှု၊ breaking changes နှင့် သင့် integration ကို downtime မရှိဘဲ migration ပြုလုပ်နည်းများ ပါဝင်သည်။

Migration ၏ အဓိက အချက်များ-

Semantic Versioning — MAJOR.MINOR.PATCH format ကို တင်းကြပ်စွာ လိုက်နာသည်
Long-Term Support — ယခင်မေဂျာဗားရှင်းကို ၂၄ လထက်ပို၍ ပံ့ပိုးသည်
Deprecation Warnings — Breaking changes အားလုံးအတွက် ၆ လကြိုတင် အသိပေးချက်
Parallel Versions — Migration ကာလအတွင်း v1 နှင့် v2 ကို တစ်ပြိုင်နက် လည်ပတ်နိုင်သည်
Automated Testing — Test suite compatibility tools များ ပံ့ပိုးပေးထားသည်

လက်ရှိအခြေအနေ- v1 (လက်ရှိ), v2 (beta, general availability Q2 2026). v1 ကို Q1 2028 အထိ ပံ့ပိုးမည်။

Versioning Policy

Semantic Versioning

Version Format
API Version: MAJOR.MINOR.PATCH
Example: 2.1.3
MAJOR (2) - Breaking changes, new architecture
MINOR (1) - Backward-compatible features
PATCH (3) - Bug fixes, security updates

Version Release Cycle

Phase	Duration	Characteristics
Alpha	2-4 weeks	Heavy breaking changes, testing only
Beta	4-8 weeks	Mostly stable, community feedback
Release Candidate	2-4 weeks	Production-ready, final polish
General Availability	24+ months	Full production support

Get your API key in 30 seconds

Ready to build? Grab a free API key (200 calls/day, no card) and start pulling live whale, funding and on-chain data.

Get your API key →

Backward Compatibility

Version Compatibility

မေဂျာဗားရှင်းတစ်ခုအတွင်း၊ သင်သည် အသစ်သော minor/patch ဗားရှင်းများသို့ ဘေးကင်းစွာ အဆင့်မြှင့်တင်နိုင်သည်-

Endpoint URLs — ပြောင်းလဲမှုမရှိ
Required Fields — ဖယ်ရှားခြင်းမရှိ (အသစ်သော optional fields များသာ ထည့်သွင်းသည်)
HTTP Status Codes — ရှိပြီးသော scenarios များအတွက် ထိန်းသိမ်းထားသည်
Response Structure — Core fields များ အတူတူပင်ဖြစ်သည်
Authentication — auth mechanisms တွင် ပြောင်းလဲမှုမရှိ

Graceful Deprecation

Deprecation Timeline
// Month 1: Announce deprecation
// Feature marked with Deprecation header
Deprecation: version="2.2", sunset="2026-09-01"
// Month 3-6: Active deprecation period
// API returns warnings but still works
X-Deprecation-Warning: This endpoint will be removed on 2026-09-01
// Month 6: Final removal
// Endpoint returns 410 Gone
HTTP/1.1 410 Gone

V1 မှ V2 သို့ Migration

Major Changes

REST API Redesign — ပိုမိုရှင်းလင်းသော resource endpoints
Response Format — တစ်သမတ်တည်း wrapping၊ ပိုမိုကောင်းမွန်သော error handling
Authentication — OAuth 2.0 support ထည့်သွင်း (API keys များ အလုပ်လုပ်ဆဲ)
Rate Limiting — Improved granularity and clarity
Webhooks — Redesigned event format and signing

Endpoint Mapping

v1 Endpoint	v2 Endpoint	Changes
GET /whales	GET /v2/whales/tracking	Reorganized, added filtering
GET /funding	GET /v2/derivatives/funding-heatmap	Exchange parameter required
GET /positions	GET /v2/derivatives/positions	New aggregation options

Endpoint Changes

Request Parameter Changes

V1 Request
// V1: Funding rates
GET /v1/funding?symbol=BTCUSDT&exchange=binance

V2 Request
// V2: Same data, clearer structure
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

Response Format Updates

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
  }
}

အဓိက ကွဲပြားချက်များ status wrapper မပါ၊ ပိုရှင်းသော field အမည်များ၊ စံသတ်မှတ်ထားသော metadata။

ဖျက်သိမ်းမည့် အချိန်ဇယား

အစီအစဉ်ချ ဖျက်သိမ်းမှုများ

အင်္ဂါရပ်	ကြေငြာခဲ့သည့်ရက်	ဖျက်သိမ်းမည့်ရက်	အစားထိုး
/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 (keys များ အလုပ်လုပ်ဆဲ)
Webhook v1 ဖော်မတ်	Q2 2026	Q2 2027	Webhook v2 ဖော်မတ်

ပြောင်းလဲမှုများ အသေးစိတ်

ဖယ်ရှားပြီး endpoint များ

/v1/stats — /v2/metrics ဖြင့် အစားထိုး
/v1/historical — ပါရာမီတာအသစ်များဖြင့် /v2/historical ဖြင့် အစားထိုး
/v1/alerts/create — POST /v2/alerts ဖြင့် အစားထိုး

ပါရာမီတာ ပြောင်းလဲမှုများ

limit — Default ကို 100 မှ 20 သို့ ပြောင်းလဲ (ရှင်းလင်းစွာ ဖော်ပြပါ)
timeframe — historical queries တွင် ယခု လိုအပ်သည်
sort — ဖော်မတ်ကို "field asc" မှ "field:asc" သို့ ပြောင်းလဲ

တုံ့ပြန်မှု field ပြောင်းလဲမှုများ

funding → funding_rate
price → mark_price
vol → volume_quote

အဆင့်ဆင့် ပြောင်းရွှေ့မှု

အဆင့် 1: အစီအစဉ်ချမှတ်ခြင်း (အပတ် 1-2)

ဖျက်သိမ်းပြီး အင်္ဂါရပ်များအတွက် လက်ရှိ integration ကို စစ်ဆေးပါ
v1 endpoint များကို v2 နှင့် တူညီသော အရာများနှင့် ချိတ်ဆက်ပါ
သင့်ကုဒ်ကို ထိခိုက်စေမည့် ပြောင်းလဲမှုများကို ဖော်ထုတ်ပါ
စမ်းသပ်မှု နည်းဗျူဟာနှင့် အချိန်ဇယားကို စီစဉ်ပါ

အဆင့် 2: ဖွံ့ဖြိုးမှု (အပတ် 3-4)

version control တွင် v2 branch ဖန်တီးပါ
API endpoint အားလုံးကို v2 URL များသို့ အပ်ဒိတ်လုပ်ပါ
တောင်းဆိုမှု/တုံ့ပြန်မှု ကိုင်တွယ်မှုကို အပ်ဒိတ်လုပ်ပါ
sandbox တွင် unit test များ လုပ်ဆောင်ပါ

အဆင့် 3: စမ်းသပ်မှု (အပတ် 5-6)

ပြည့်စုံသော integration test suite ကို လုပ်ဆောင်ပါ
အမှားအခြေအနေများနှင့် edge case များကို စမ်းသပ်ပါ
v2 endpoint များဖြင့် load testing လုပ်ပါ
အပ်ဒိတ်လုပ်ထားသော ကုဒ်၏ လုံခြုံရေး စစ်ဆေးမှု

အဆင့် 4: Staging (အပတ် 7)

v2 ကုဒ်ကို staging environment သို့ deploy လုပ်ပါ
ပြည့်စုံသော acceptance test များ လုပ်ဆောင်ပါ
stakeholder များထံမှ အတည်ပြုချက် ရယူပါ
ပြန်လည်ရုပ်သိမ်းရန် အစီအစဉ် ပြင်ဆင်ပါ

အဆင့် 5: Production (အပတ် 8)

blue-green deploy ဖြင့် production သို့ deploy လုပ်ပါ
မက်ထရစ်နှင့် အမှားနှုန်းများကို စောင့်ကြည့်ပါ
ပံ့ပိုးမှု အကူအညီအတွက် အဆင့်မြင့်နေပါ
v1 ကုဒ်ကို တဖြည်းဖြည်း ရပ်ဆိုင်းပါ

ပံ့ပိုးမှုနှင့် အရင်းအမြစ်များ

ရနိုင်သော ကိရိယာများ

ပြောင်းရွှေ့မှု စစ်ဆေးသူ — ဖျက်သိမ်းပြီး အသုံးပြုမှုအတွက် ကုဒ်ကို စစ်ဆေးပါ
API အဆင့်မြှင့်တင်မှု စစ်ဆေးသူ — v1 နှင့် v2 ကိုက်ညီမှုကို နှိုင်းယှဉ်ပါ
ပြောင်းရွှေ့မှု စာရင်း — task များနှင့် အချိန်ဇယားပါသော PDF
ကုဒ် နမူနာများ — ပြောင်းရွှေ့မှု မတိုင်မီ/ပြီး နမူနာများ

အကူအညီ ရယူခြင်း

Email: [email protected]
Documentation: See changelog-versioning.html
Discord: Community support channel
Enterprise: Dedicated migration engineer

သင့်ပြောင်းရွှေ့မှုကို ယနေ့စတင်ပါ

ပြည့်စုံသော ပြောင်းရွှေ့မှု ကိရိယာများ၊ စာရွက်စာတမ်းများနှင့် ပံ့ပိုးမှုဖြင့် API v2 သို့ အဆင့်မြှင့်ပါ။ Zero-downtime ပြောင်းရွှေ့မှုကို ပံ့ပိုးရန် တည်ဆောက်ထားသည်။

V2 ကို စူးစမ်းပါ

V1 ကို Jan 2028 အထိ ပံ့ပိုးမည်။ သင့်ပြောင်းရွှေ့မှုကို ယနေ့စီစဉ်ပါ။