ত্রুটির কোড এবং অবস্থা রেফারেন্স

Smart Money API এর ত্রুটির কোড, HTTP অবস্থা কোড এবং সমস্যা সমাধানের ধাপগুলির বিস্তৃত গাইড। ত্রুটি প্রতিক্রিয়া বুঝুন এবং ইন্টিগ্রেশন সমস্যা দ্রুত সমাধান করুন।

2xx সাফল্য কোড

সাফল্য প্রতিক্রিয়া নির্দেশ করে যে অনুরোধটি সফলভাবে প্রক্রিয়াকরণ করা হয়েছে।

কোড	অবস্থা	অর্থ
200	ঠিক আছে	অনুরোধ সফল হয়েছে। প্রতিক্রিয়া বডিতে অনুরোধ করা ডেটা রয়েছে।
201	তৈরি হয়েছে	সম্পদ সফলভাবে তৈরি করা হয়েছে। প্রতিক্রিয়ায় নতুন সম্পদ অন্তর্ভুক্ত রয়েছে।
204	কোনো কন্টেন্ট নেই	অনুরোধ সফল হয়েছে কিন্তু ফেরত দেওয়ার জন্য কোনো কন্টেন্ট নেই (যেমন, DELETE)।

উদাহরণ 200 প্রতিক্রিয়া

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx ক্লায়েন্ট ত্রুটি কোড

ক্লায়েন্ট ত্রুটি নির্দেশ করে যে অনুরোধটি ভুলভাবে গঠিত বা অবৈধ ছিল। আপনার অনুরোধ ঠিক করুন এবং পুনরায় চেষ্টা করুন।

কোড	অবস্থা	কারণ
400	খারাপ অনুরোধ	ভুলভাবে গঠিত অনুরোধ সিনট্যাক্স। ক্যোয়ারী প্যারামিটার, হেডার এবং অনুরোধ বডি পরীক্ষা করুন।
401	অননুমোদিত	প্রমাণীকরণ ক্রেডেনশিয়াল অনুপস্থিত বা অবৈধ। আপনার API কী বা JWT টোকেন পরীক্ষা করুন।
402	পেমেন্ট প্রয়োজন	আপনার সাবস্ক্রিপশন পেমেন্ট ব্যর্থ হয়েছে। আপনার অ্যাকাউন্টে বিলিং তথ্য আপডেট করুন।
403	নিষিদ্ধ	প্রমাণীকরণ করা হয়েছে কিন্তু এই সম্পদের জন্য অনুমোদিত নয়। আপনার প্ল্যানে এই বৈশিষ্ট্য অন্তর্ভুক্ত নেই।
404	পাওয়া যায়নি	সম্পদ বিদ্যমান নেই। এন্ডপয়েন্ট URL এবং প্যারামিটার পরীক্ষা করুন।
429	অনেক অনুরোধ	হার সীমা অতিক্রম করেছে। পুনরায় চেষ্টা করার আগে অপেক্ষা করুন। Retry-After হেডার পরীক্ষা করুন।
422	প্রক্রিয়াকরণযোগ্য নয়	যাচাইকরণ ব্যর্থ হয়েছে। অনুরোধ প্যারামিটার অবৈধ বা প্রয়োজনীয় ফিল্ড অনুপস্থিত।

প্রমাণীকরণ ত্রুটি উদাহরণ

অনুপস্থিত API কী (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "প্রমাণীকরণ ক্রেডেনশিয়াল প্রদান করা হয়নি।",
    "resolution": "Authorization হেডারে আপনার API কী অন্তর্ভুক্ত করুন: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

অবৈধ API কী (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "অবৈধ বা মেয়াদোত্তীর্ণ API কী।",
    "resolution": "https://smartmoneyapi.com/console থেকে আপনার কনসোল থেকে একটি নতুন API কী তৈরি করুন"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

হার সীমাবদ্ধতা (429)

আপনি যখন আপনার API কোটা অতিক্রম করেন, সার্ভার 429 Too Many Requests ফেরত দেয়। হার সীমা তথ্যের জন্য প্রতিক্রিয়া হেডার পরীক্ষা করুন:

HTTP হেডার

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

হার সীমা ত্রুটি প্রতিক্রিয়া

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "দৈনিক API অনুরোধ সীমা (10) অতিক্রম করেছে।",
    "resolution": "ট্রেডার ($29/মাস, 400 অনুরোধ/দিন) বা প্রো ($79/মাস, 4,000 অনুরোধ/দিন) প্ল্যানে আপগ্রেড করুন।",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

যাচাইকরণ ত্রুটি (422)

যাচাইকরণ ত্রুটি ঘটে যখন আপনার অনুরোধ প্যারামিটার অবৈধ বা প্রয়োজনীয় ফিল্ড অনুপস্থিত।

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "অনুরোধ যাচাইকরণ ব্যর্থ হয়েছে।",
    "details": [
      {
        "field": "symbol",
        "error": "অবৈধ ট্রেডিং পেয়ার। প্রত্যাশিত ফরম্যাট: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "একটি ধনাত্মক সংখ্যা হতে হবে"
      }
    ],
    "resolution": "যাচাইকরণ ত্রুটি ঠিক করুন এবং পুনরায় চেষ্টা করুন।"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx সার্ভার ত্রুটি কোড

সার্ভার ত্রুটি আমাদের পক্ষে একটি সমস্যা নির্দেশ করে। এগুলি অস্থায়ী এবং সাধারণত দ্রুত সমাধান হয়। এক্সপোনেনশিয়াল ব্যাকঅফ রিট্রাই লজিক প্রয়োগ করুন।

কোড	অবস্থা	কর্ম
500	অভ্যন্তরীণ ত্রুটি	অপ্রত্যাশিত সার্ভার ত্রুটি। এক্সপোনেনশিয়াল ব্যাকঅফ দিয়ে পুনরায় চেষ্টা করুন।
502	খারাপ গেটওয়ে	অস্থায়ী পরিষেবা বিঘ্ন। কয়েক সেকেন্ড পরে পুনরায় চেষ্টা করুন।
503	পরিষেবা অনুপলব্ধ	রক্ষণাবেক্ষণ বা অস্থায়ী আউটেজ। অবস্থা পৃষ্ঠা পরীক্ষা করুন। Retry-After ব্যবধানের পরে পুনরায় চেষ্টা করুন।
504	গেটওয়ে টাইমআউট	অনুরোধটি খুব বেশি সময় নিয়েছে। সার্ভার এটি প্রক্রিয়া করতে পারে। ইডেম্পোটেন্সি পরীক্ষা করুন।

সার্ভার ত্রুটি উদাহরণ (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "রক্ষণাবেক্ষণের কারণে পরিষেবা অস্থায়ীভাবে অনুপলব্ধ।",
    "resolution": "5 মিনিট পরে পুনরায় চেষ্টা করুন। অবস্থা ট্র্যাক করুন https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

সমস্যা সমাধান গাইড

401 অননুমোদিত - অবৈধ API কী

সমস্যা: একটি API কী থাকা সত্ত্বেও 401 ত্রুটি পাওয়া যাচ্ছে।

সমাধান:

নিশ্চিত করুন যে API কী "Bearer" প্রিফিক্স সহ Authorization হেডারে অন্তর্ভুক্ত আছে
পরীক্ষা করুন যে আপনার API কী মেয়াদোত্তীর্ণ বা বাতিল করা হয়নি
নিশ্চিত করুন যে আপনি সঠিক কী ব্যবহার করছেন (প্রোডাকশন, স্টেজিং, বা ডেভেলপমেন্ট)
যদি বর্তমান কী হারিয়ে যায় তবে আপনার কনসোল থেকে একটি নতুন API কী তৈরি করুন

403 নিষিদ্ধ - বৈশিষ্ট্য উপলব্ধ নয়

সমস্যা: নির্দিষ্ট এন্ডপয়েন্টে 403 ত্রুটি পাওয়া যাচ্ছে।

সমাধান:

আপনার API স্তর পরীক্ষা করুন। কিছু এন্ডপয়েন্টের জন্য ট্রেডার বা প্রো প্ল্যান প্রয়োজন
প্রিমিয়াম বৈশিষ্ট্যগুলি অ্যাক্সেস করতে /pricing.html এ আপনার প্ল্যান আপগ্রেড করুন
নিশ্চিত করুন যে API কীতে প্রয়োজনীয় স্কোপ সক্ষম আছে
আপনার যদি অ্যাক্সেস থাকা উচিত বলে মনে হয় তবে সমর্থন দলের সাথে যোগাযোগ করুন

429 অনেক অনুরোধ - হার সীমাবদ্ধ

সমস্যা: 429 ত্রুটি এবং হার সীমাবদ্ধতা পাওয়া যাচ্ছে।

সমাধান:

এক্সপোনেনশিয়াল ব্যাকঅফ রিট্রাই লজিক প্রয়োগ করুন (1s, 2s, 4s, ইত্যাদি অপেক্ষা করুন)
অপ্রয়োজনীয় API কল এড়াতে প্রতিক্রিয়া ক্যাশে করুন
রিয়েল-টাইম ডেটার জন্য REST এন্ডপয়েন্ট পোলিংয়ের পরিবর্তে WebSocket ব্যবহার করুন
উচ্চ কোটা (ট্রেডার 1,000/দিন, প্রো 5,000/দিন) এর জন্য আপনার প্ল্যান আপগ্রেড করুন
একাধিক ক্যোয়ারীকে যেখানে সম্ভব একক অনুরোধে ব্যাচ করুন

400 খারাপ অনুরোধ - অবৈধ প্যারামিটার

সমস্যা: ভুলভাবে গঠিত অনুরোধ সহ 400 ত্রুটি পাওয়া যাচ্ছে।

সমাধান:

প্রয়োজনীয় এবং ঐচ্ছিক প্যারামিটারের জন্য API ডকুমেন্টেশন পরীক্ষা করুন
প্যারামিটার টাইপ পরীক্ষা করুন (স্ট্রিং বনাম সংখ্যা, অ্যারে বনাম অবজেক্ট)
JSON বৈধ এবং সঠিকভাবে ফরম্যাট করা হয়েছে তা নিশ্চিত করুন
সঠিক এন্ডপয়েন্ট URL ব্যবহার করুন যাতে সঠিক পাথ প্যারামিটার থাকে
কোয়েরি প্যারামিটার নামে টাইপো পরীক্ষা করুন

5xx সার্ভার ত্রুটি - অস্থায়ী বাধা

সমস্যা: 500, 502, 503, বা 504 ত্রুটি পাচ্ছেন।

সমাধান:

https://status.smartmoneyapi.com এ সার্ভিস স্ট্যাটাস পরীক্ষা করুন
এক্সপোনেনশিয়াল ব্যাকঅফ সহ স্বয়ংক্রিয় পুনরায় চেষ্টা বাস্তবায়ন করুন (সর্বোচ্চ 5-10 বার)
503 ত্রুটির ক্ষেত্রে পুনরায় চেষ্টা করার আগে 30-60 সেকেন্ড অপেক্ষা করুন
পুনরায় চেষ্টার সময় নির্ধারণ করতে Retry-After হেডার ব্যবহার করুন
ঘটনা বিজ্ঞপ্তির জন্য স্ট্যাটাস পৃষ্ঠায় সাবস্ক্রাইব করুন

ত্রুটি প্রতিক্রিয়া ফরম্যাট

সমস্ত ত্রুটি প্রতিক্রিয়া একটি সামঞ্জস্যপূর্ণ ফরম্যাট অনুসরণ করে:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "মানব-পাঠযোগ্য ত্রুটি বার্তা",
    "details": {...},
    "resolution": "সমস্যা সমাধানের পদক্ষেপ"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

আরও সাহায্য প্রয়োজন?

আমাদের API ডকুমেন্টেশন পরীক্ষা করুন বা আপনার ত্রুটি কোড এবং অনুরোধের বিবরণ সহ সাপোর্টে যোগাযোগ করুন।

API রেফারেন্স

সাপোর্ট পান

প্রশ্ন আছে? আমাদের ডকুমেন্টেশন পরীক্ষা করুন বা সাপোর্টে যোগাযোগ করুন।

কনসোল খুলুন