API ডকুমেন্টেশন

API Migration Guide — Upgrading Between Versions

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 কী নিন (100 কল/দিন, কোন কার্ড নেই) এবং লাইভ হোয়েল, ফান্ডিং এবং অন-চেইন ডেটা টানতে শুরু করুন।

আপনার API কী পান →

পূর্ববর্তী সামঞ্জস্যতা

ভার্সন সামঞ্জস্যতা

একটি মেজর ভার্সনের মধ্যে, আপনি সর্বদা নতুন মাইনর/প্যাচ ভার্সনে নিরাপদে আপগ্রেড করতে পারেন:

  • এন্ডপয়েন্ট URL — অপরিবর্তিত থাকে
  • প্রয়োজনীয় ফিল্ড — কখনই সরানো হয় না (শুধুমাত্র নতুন অপশনাল ফিল্ড যোগ করা হয়)
  • HTTP স্ট্যাটাস কোড — বিদ্যমান পরিস্থিতির জন্য সংরক্ষিত
  • রেসপন্স স্ট্রাকচার — মূল ফিল্ডগুলি অভিন্ন থাকে
  • অথেন্টিকেশন — অথেন্টিকেশন মেকানিজমে কোন পরিবর্তন নেই

গ্রেসফুল ডিপ্রিকেশন

ডিপ্রিকেশন টাইমলাইন
// মাস 1: ডিপ্রিকেশন ঘোষণা
// ফিচার ডিপ্রিকেশন হেডার দিয়ে চিহ্নিত
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 কী শুধুমাত্র অথেন্টিকেশন 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 — এখন historical কোয়েরিতে প্রয়োজন
  • 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 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 Jan 2028 পর্যন্ত সাপোর্টেড। আজই আপনার মাইগ্রেশন পরিকল্পনা করুন।

সম্পর্কিত রিসোর্সেস

চেঞ্জলগ ও ভার্সনিং →

বিস্তারিত ভার্সন ইতিহাস

REST API রেফারেন্স →

V2 API ডকুমেন্টেশন

টেস্টিং গাইড →

টেস্টিংয়ের জন্য স্যান্ডবক্স এনভায়রনমেন্ট
ফ্রি শুরু করুন — 100 কল/দিন, কোন কার্ড নেই

একটি API থেকে 3 এক্সচেঞ্জে লাইভ হোয়েল ফ্লো, ফান্ডিং, ওপেন ইন্টারেস্ট এবং অন-চেইন ডেটা পান। ফ্রি টিয়ার, কোন ক্রেডিট কার্ড নেই, যেকোনো সময় আপগ্রেড করুন।

ফ্রি শুরু করুন →
লাইভ API কনসোল ট্রাই করুন → (কোন অ্যাকাউন্ট প্রয়োজন নেই)