ত্রুটি কোড - API ডকুমেন্টেশন

ত্রুটি প্রতিক্রিয়া বিন্যাস

সকল ত্রুটি প্রতিক্রিয়া একই বিন্যাস ব্যবহার করে:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "পাঠযোগ্য ত্রুটি বার্তা",
    "details": "অতিরিক্ত প্রসঙ্গ (ঐচ্ছিক)"
  }
}

💡 স্থিতিশীল শর্ত হিসাবে error.code ব্যবহার করুন (ত্রুটি বার্তা পরিবর্তন হতে পারে)

HTTP স্ট্যাটাস কোড

200 OK

অনুরোধ সফল

200

201 Created

রিসোর্স সফলভাবে তৈরি হয়েছে

201

400 Bad Request

অনুরোধের প্যারামিটার ভুল

400

{
  "code": "INVALID_REQUEST",
  "message": "অনুরোধের বিন্যাস ভুল"
}

401 Unauthorized

Authenticated নয় বা API key ভুল

401

{
  "code": "UNAUTHORIZED",
  "message": "ভুল বা expired API key"
}

403 Forbidden

অ্যাকাউন্টের ব্যালেন্স অপর্যাপ্ত বা অনুমতি নেই

403

{
  "code": "INSUFFICIENT_BALANCE",
  "message": "অ্যাকাউন্টের ব্যালেন্স অপর্যাপ্ত"
}

404 Not Found

রিসোর্স বিদ্যমান নেই

404

{
  "code": "ORDER_NOT_FOUND",
  "message": "Order বিদ্যমান নেই"
}

409 Conflict

রিসোর্সে দ্বন্দ্ব আছে

409

{
  "code": "ADDRESS_EXISTS",
  "message": "Address ইতিমধ্যে বিদ্যমান"
}

429 Too Many Requests

API key এর rate limit অতিক্রম করেছে

429

{
  "code": "RATE_LIMITED",
  "message": "Rate limit অতিক্রম করেছে"
}

500 Internal Server Error

সার্ভারের অভ্যন্তরীণ ত্রুটি

500

{
  "code": "INTERNAL_ERROR",
  "message": "অপ্রত্যাশিত ত্রুটি ঘটেছে"
}

503 Service Unavailable

সেবা সাময়িকভাবে অনুপলব্ধ (বর্তমানে পুনরুদ্ধার হচ্ছে)

503

{
  "code": "SERVICE_UNAVAILABLE",
  "message": "সেবা সাময়িকভাবে অনুপলব্ধ"
}

সাধারণ ত্রুটি কোড

Error Code	Status	Description	Solution
UNAUTHORIZED	401	ভুল, expired, বা revoked API key	API key সঠিক কিনা পরীক্ষা করুন, প্রয়োজনে নতুন তৈরি করুন
INSUFFICIENT_BALANCE	403	অ্যাকাউন্টের ব্যালেন্স অপর্যাপ্ত	অ্যাকাউন্ট রিচার্জ করুন
INVALID_ADDRESS	400	TRON address এর বিন্যাস ভুল	সঠিক TRON address কিনা পরীক্ষা করুন (T দিয়ে শুরু)
INVALID_ENERGY_AMOUNT	400	Energy এর পরিমাণ ভুল	Energy এর পরিমাণ অবশ্যই ধনাত্মক পূর্ণসংখ্যা হতে হবে, USDT স্থানান্তরের জন্য 65000 সুপারিশ করা হয়
INVALID_DURATION	400	ভাড়ার সময়কাল ভুল	বৈধ সময়কাল ব্যবহার করুন: 1H, 1D, 3D, 7D, 14D, 30D
ORDER_NOT_FOUND	404	Order নেই	Order ID সঠিক কিনা পরীক্ষা করুন
ADDRESS_EXISTS	409	Address ইতিমধ্যে বিদ্যমান	Address ইতিমধ্যে যোগ করা হয়েছে কিনা পরীক্ষা করুন বা বিদ্যমান address ব্যবহার করুন
RATE_LIMITED	429	API key এর rate limit অতিক্রম করেছে (বর্তমানে শুধুমাত্র POST /v1/wallet/recharges এ প্রয়োগ করা হয়)	Exponential backoff সহ পুনরায় চেষ্টা করুন বা অনুরোধের হার কমান

পরিচালনা পদ্ধতি

Error	Handling
401 UNAUTHORIZED	API key পরীক্ষা/Rotate করুন
403 INSUFFICIENT_BALANCE	রিচার্জ করুন বা অনুরোধের পরিমাণ কমান
409 ADDRESS_EXISTS	Query/idempotent processing এ স্থানান্তর করুন
429 RATE_LIMITED	অপেক্ষা সহ পুনরায় চেষ্টা করুন (Retry-After উপলব্ধ থাকলে অনুসরণ করুন, অন্যথায় exponential backoff ব্যবহার করুন)
5xx	পুনরায় চেষ্টা করুন + অনুরোধের প্রসঙ্গ লগ করুন

পুনরায় চেষ্টার নির্দেশিকা

• সর্বোচ্চ পুনরায় চেষ্টা: ৩ বার
• অপেক্ষা: exponential (১ সেকেন্ড, ২ সেকেন্ড, ৪ সেকেন্ড...)
• শুধুমাত্র 429/5xx এ পুনরায় চেষ্টা করুন
• 4xx এ পুনরায় চেষ্টা করবেন না (client-side ত্রুটি)

ত্রুটি কোড এবং পরিচালনা