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+ සම්පූර්ණ නිෂ්පාදන සහය
තත්පර 30 කින් ඔබේ API යතුර ලබා ගන්න

නිර්මාණය කිරීමට සූදානම්ද? නොමිලේ API යතුරක් ගන්න (දිනකට ඇමතුම් 50, කාඩ්පතක් නැත) සහ සජීවී තල්මසා, අරමුදල් සහ චේන් තුළ දත්ත ගැනීම ආරම්භ කරන්න.

ඔබේ API යතුර ලබා ගන්න →

පසුබෑමට ගැලපෙන බව

අනුවාද ගැලපුම

ප්‍රධාන අනුවාදයක් තුළ, ඔබට සැමවිටම නවතම අඩු/පැච් අනුවාද වලට ආරක්ෂිතව උත්ශ්‍රේණි කළ හැකිය:

  • අන්ත ලක්ෂ්‍ය URL — නොවෙනස්ව පවතී
  • අවශ්‍ය ක්ෂේත්‍ර — කිසිවිටෙක ඉවත් නොකෙරේ (නව විකල්ප ක්ෂේත්‍ර පමණක් එකතු කරනු ලැබේ)
  • 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 Exchange පරාමිතිය අවශ්‍යයි
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 ජන 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" දක්වා වෙනස් විය

ප්‍රතිචාර ක්ෂේත්‍ර වෙනස්කම්

  • funding → funding_rate
  • price → mark_price
  • vol → volume_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 බලන්න
  • Discord: ප්‍රජා සහාය නාලිකාව
  • ව්‍යවසාය: කැපවූ සංක්‍රමණ ඉංජිනේරු

ඔබේ සංක්‍රමණය අදම ආරම්භ කරන්න

API v2 වෙත උත්ශ්‍රේණි කරන්න සම්පූර්ණ සංක්‍රමණ මෙවලම්, ලේඛන, සහ සහාය සමඟ. බිංදු-අඩු කාලය සංක්‍රමණයට සහාය වීමට නිර්මාණය කර ඇත.

V2 ගවේෂණය කරන්න
V1 2028 ජනවාරි දක්වා සහාය වේ. ඔබේ සංක්‍රමණය අදම සැලසුම් කරන්න.

ආශ්‍රිත සම්පත්

Changelog & Versioning →

විස්තරාත්මක අනුවාද ඉතිහාසය

REST API යොමුව →

V2 API ලේඛන

පරීක්ෂණ මාර්ගෝපදේශය →

පරීක්ෂණ සඳහා සැන්ඩ්බොක්ස් පරිසරය
නොමිලේ ආරම්භ කරන්න — දිනකට 50 ඇමතුම්, කාඩ්පතක් නැත

එක් API එකකින් 3 වෙළඳපොලවල්වල සත්‍ය තල්මස් ප්‍රවාහය, අරමුදල්, විවෘත උනන්දුව සහ චේන් දත්ත ලබා ගන්න. නොමිලේ තට්ටුව, ක්‍රෙඩිට් කාඩ්පතක් නැත, ඕනෑම වේලාවක උත්ශ්‍රේණි කරන්න.

නොමිලේ ආරම්භ කරන්න →
සත්‍ය API කොන්සෝලය උත්සාහ කරන්න → (ගිණුමක් අවශ්‍ය නැත)