အမှားကုဒ်များနှင့် အခြေအနေအညွှန်း

Smart Money API ၏ အမှားကုဒ်များ၊ HTTP အခြေအနေကုဒ်များနှင့် ပြဿနာဖြေရှင်းနည်းများအား အပြည့်အစုံလမ်းညွှန်။ အမှားတုံ့ပြန်မှုများကို နားလည်ပြီး ပေါင်းစပ်မှုပြဿနာများကို မြန်မြန်ဖြေရှင်းပါ။

2xx အောင်မြင်မှုကုဒ်များ

အောင်မြင်သော တုံ့ပြန်မှုများသည် တောင်းဆိုမှုအား အောင်မြင်စွာ လုပ်ဆောင်ပြီးကြောင်း ဖော်ပြသည်။

ကုဒ်	အခြေအနေ	အဓိပ္ပာယ်
200	OK	တောင်းဆိုမှု အောင်မြင်ပါသည်။ တုံ့ပြန်မှုတွင် တောင်းဆိုထားသော အချက်အလက်များ ပါဝင်သည်။
201	Created	အရင်းအမြစ်အား အောင်မြင်စွာ ဖန်တီးပြီးပါပြီ။ တုံ့ပြန်မှုတွင် အသစ်ဖန်တီးထားသော အရင်းအမြစ် ပါဝင်သည်။
204	No Content	တောင်းဆိုမှု အောင်မြင်သော်လည်း ပြန်လည်ပေးပို့ရန် အကြောင်းအရာ မရှိပါ (ဥပမာ - DELETE)

ဥပမာ 200 တုံ့ပြန်မှု

JSON

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

4xx ကလိုင်းယင့်အမှားကုဒ်များ

ကလိုင်းယင့်အမှားများသည် တောင်းဆိုမှုအား မှားယွင်းစွာ ဖွဲ့စည်းထားခြင်း သို့မဟုတ် မမှန်ကန်ကြောင်း ဖော်ပြသည်။ တောင်းဆိုမှုအား ပြုပြင်ပြီး ပြန်လည်ကြိုးစားပါ။

ကုဒ်	အခြေအနေ	အကြောင်းရင်း
400	Bad Request	တောင်းဆိုမှု ဖွဲ့စည်းပုံ မှားယွင်းနေပါသည်။ Query parameters၊ headers နှင့် တောင်းဆိုမှုခန္ဓာကိုယ်အား စစ်ဆေးပါ။
401	Unauthorized	အထောက်အထားစစ်ဆေးမှု အထောက်အထားများ ပျောက်နေခြင်း သို့မဟုတ် မမှန်ကန်ပါ။ သင့် API key သို့မဟုတ် JWT token အား စစ်ဆေးပါ။
402	Payment Required	သင့်စာရင်းသွင်းမှု ငွေပေးချေမှု မအောင်မြင်ပါ။ သင့်အကောင့်ရှိ ငွေပေးချေမှုအချက်အလက်များအား အပ်ဒိတ်လုပ်ပါ။
403	Forbidden	အထောက်အထားစစ်ဆေးမှု အောင်မြင်သော်လည်း ဤအရင်းအမြစ်အတွက် ခွင့်ပြုချက် မရှိပါ။ သင့်အစီအစဉ်တွင် ဤအင်္ဂါရပ်ပါဝင်မှု မရှိပါ။
404	Not Found	အရင်းအမြစ် မရှိပါ။ endpoint URL နှင့် parameters များအား စစ်ဆေးပါ။
429	Too Many Requests	အကန့်အသတ်နှုန်း ကျော်လွန်သွားပါသည်။ ပြန်လည်ကြိုးစားမှုမပြုမီ စောင့်ပါ။ Retry-After header အား စစ်ဆေးပါ။
422	Unprocessable Entity	အတည်ပြုချက် မအောင်မြင်ပါ။ တောင်းဆိုမှု parameters များ မမှန်ကန်ခြင်း သို့မဟုတ် လိုအပ်သော အကွက်များ ပျောက်နေပါသည်။

အထောက်အထားစစ်ဆေးမှု အမှားများ ဥပမာ

API Key ပျောက်နေခြင်း (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "အထောက်အထားစစ်ဆေးမှု အထောက်အထားများ မပါဝင်ပါ။",
    "resolution": "Authorization header တွင် သင့် API key ထည့်သွင်းပါ: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

မမှန်ကန်သော API Key (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "မမှန်ကန်သော သို့မဟုတ် သက်တမ်းကုန်သွားသော API key။",
    "resolution": "https://smartmoneyapi.com/console တွင် အသစ်သော API key ထုတ်ပါ။"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

အကန့်အသတ်နှုန်း (429)

သင်၏ API quota ကို ကျော်လွန်သောအခါ၊ ဆာဗာမှ 429 Too Many Requests ကို ပြန်ပို့ပါမည်။ အကန့်အသတ်နှုန်း အချက်အလက်များအတွက် တုံ့ပြန်မှု headers များကို စစ်ဆေးပါ:

HTTP Headers

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": "Trader ($29/လ၊ တောင်းဆိုမှု 1,000/နေ့) သို့မဟုတ် Pro ($79/လ၊ တောင်းဆိုမှု 5,000/နေ့) အစီအစဉ်သို့ အဆင့်မြှင့်ပါ။",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

အတည်ပြုချက် အမှားများ (422)

အတည်ပြုချက်အမှားများသည် တောင်းဆိုမှု parameters များ မမှန်ကန်ခြင်း သို့မဟုတ် လိုအပ်သော အကွက်များ ပျောက်နေသောအခါ ဖြစ်ပေါ်သည်။

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "တောင်းဆိုမှု အတည်ပြုချက် မအောင်မြင်ပါ။",
    "details": [
      {
        "field": "symbol",
        "error": "မမှန်ကန်သော trading pair။ မျှော်မှန်းထားသော ဖော်မတ်: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "အပေါင်းကိန်းဂဏန်း ဖြစ်ရပါမည်"
      }
    ],
    "resolution": "အတည်ပြုချက်အမှားများကို ပြုပြင်ပြီး ပြန်လည်ကြိုးစားပါ။"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx ဆာဗာအမှားကုဒ်များ

ဆာဗာအမှားများသည် ကျွန်ုပ်တို့ဘက်တွင် ပြဿနာရှိကြောင်း ဖော်ပြသည်။ ဤအမှားများသည် ယာယီဖြစ်ပြီး မကြာခဏ အမြန်ပြေလည်သွားတတ်သည်။ Exponential backoff retry logic ကို အကောင်အထည်ဖော်ပါ။

ကုဒ်	အခြေအနေ	လုပ်ဆောင်ချက်
500	Internal Error	မမျှော်လင့်ထားသော ဆာဗာအမှား။ Exponential backoff ဖြင့် ပြန်လည်ကြိုးစားပါ။
502	Bad Gateway	ယာယီဝန်ဆောင်မှု အနှောင့်အယှက်။ စက္ကန့်အနည်းငယ်စောင့်ပြီး ပြန်လည်ကြိုးစားပါ။
503	Service Unavailable	ပြုပြင်ထိန်းသိမ်းမှု သို့မဟုတ် ယာယီဝန်ဆောင်မှုပြတ်တောက်မှု။ အခြေအနေစာမျက်နှာကို စစ်ဆေးပါ။ Retry-After အချိန်ကာလပြီးနောက် ပြန်လည်ကြိုးစားပါ။
504	Gateway Timeout	တောင်းဆိုမှု အချိန်အလွန်ကြာသွားပါသည်။ ဆာဗာမှ လုပ်ဆောင်ပြီးဖြစ်နိုင်သည်။ idempotency ကို စစ်ဆေးပါ။

ဆာဗာအမှား ဥပမာ (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "ပြုပြင်ထိန်းသိမ်းမှုကြောင့် ဝန်ဆောင်မှု ယာယီမရနိုင်ပါ။",
    "resolution": "မိနစ် 5 စောင့်ပြီးမှ ပြန်လည်ကြိုးစားပါ။ အခြေအနေကို https://status.smartmoneyapi.com တွင် စောင့်ကြည့်ပါ။"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

ပြဿနာရှာဖွေရန် လမ်းညွှန်

401 Unauthorized - မမှန်ကန်သော API Key

ပြဿနာ: API key ရှိသော်လည်း 401 အမှားများ ရနေသည်။

ဖြေရှင်းနည်းများ:

Authorization header တွင် API key ပါဝင်ပြီး "Bearer" နှင့် စတင်ထားကြောင်း အတည်ပြုပါ
သင့် API key သက်တမ်းမကုန်သေးဘဲ မဖျက်ပစ်ရသေးကြောင်း စစ်ဆေးပါ
သင်အသုံးပြုနေသော key (production, staging, or development) မှန်ကန်ကြောင်း သေချာပါစေ
လက်ရှိ key ပျောက်သွားပါက သင့်ကန်ဆိုးမှ အသစ်သော API key ထုတ်ပါ

403 Forbidden - အင်္ဂါရပ် မရနိုင်ပါ

ပြဿနာ: တချို့ endpoint များတွင် 403 အမှားများ ရနေသည်။

ဖြေရှင်းနည်းများ:

သင့် API အဆင့်ကို စစ်ဆေးပါ။ တချို့ endpoint များအတွက် Trader သို့မဟုတ် Pro အစီအစဉ်များ လိုအပ်သည်
အဆင့်မြင့်အင်္ဂါရပ်များအတွက် /pricing.html တွင် သင့်အစီအစဉ်အား အဆင့်မြှင့်ပါ
API key တွင် လိုအပ်သော scopes များ ဖွင့်ထားကြောင်း အတည်ပြုပါ
သင့်တွင် အသုံးပြုခွင့်ရှိသင့်သည်ဟု ယုံကြည်ပါက ပံ့ပိုးမှုကို ဆက်သွယ်ပါ

429 Too Many Requests - အကန့်အသတ်နှုန်း ကျော်လွန်သွားပါသည်

ပြဿနာ: 429 အမှားများနှင့် အကန့်အသတ်နှုန်း ကျော်လွန်သွားသည်။

ဖြေရှင်းနည်းများ:

Exponential backoff retry logic ကို အကောင်အထည်ဖော်ပါ (1s၊ 2s၊ 4s စသည် စောင့်ပါ)
ထပ်နေသော API တောင်းဆိုမှုများ ရှောင်ရှားရန် တုံ့ပြန်မှုများကို cache လုပ်ပါ
REST endpoints များကို poll လုပ်ခြင်းထက် WebSocket ကို အသုံးပြုပါ
အကန့်အသတ်နှုန်း ပိုမြင့်သော အစီအစဉ်များအတွက် အဆင့်မြှင့်ပါ (Trader 1,000/နေ့၊ Pro 5,000/နေ့)
ဖြစ်နိုင်လျှင် တောင်းဆိုမှုများကို တစ်ခုတည်းသော တောင်းဆိုမှုအဖြစ် စုစည်းပါ

400 Bad Request - မမှန်ကန်သော Parameters

ပြဿနာ: မှားယွင်းစွာ ဖွဲ့စည်းထားသော တောင်းဆိုမှုများနှင့် 400 အမှားများ ရနေသည်။

ဖြေရှင်းနည်းများ:

လိုအပ်သော နှင့် ရွေးချယ်နိုင်သော parameters များအတွက် API စာရွက်စာတမ်းကို စစ်ဆေးပါ
Parameter အမျိုးအစားများ (strings vs numbers, arrays vs objects) မှန်ကန်ကြောင်း အတည်ပြုပါ
JSON မှန်ကန်စွာ ဖွဲ့စည်းထားကြောင်း သေချာပါစေ
မှန်ကန်သော endpoint URLs များနှင့် လမ်းကြောင်း parameters များကို အသုံးပြုပါ
Query parameter အမည်များတွင် typing အမှားများရှိမရှိ စစ်ဆေးပါ

5xx Server Errors - ယာယီအလုပ်မလုပ်ခြင်း

ပြဿနာ: 500, 502, 503 သို့မဟုတ် 504 အမှားများရရှိခြင်း။

ဖြေရှင်းနည်းများ:

ဝန်ဆောင်မှုအခြေအနေကို https://status.smartmoneyapi.com တွင် စစ်ဆေးပါ
အလိုအလျောက် ပြန်လည်ကြိုးစားမှုကို အဆမတန် နောက်ပြန်ဆုတ်ခြင်းဖြင့် အကောင်အထည်ဖော်ပါ (အများဆုံး ၅-၁၀ ကြိုးစားမှု)
503 အမှားများကို ပြန်လည်ကြိုးစားမည့်အချိန်တွင် ၃၀-၆၀ စက္ကန့်စောင့်ပါ
ပြန်လည်ကြိုးစားရန် အချိန်ကို ဆုံးဖြတ်ရန် Retry-After header ကို အသုံးပြုပါ
အဖြစ်အပျက် အသိပေးချက်များအတွက် status page ကို subscribe လုပ်ပါ

အမှား တုံ့ပြန်မှု ပုံစံ

အမှား တုံ့ပြန်မှုအားလုံးသည် တစ်သမတ်တည်းသော ပုံစံကို လိုက်နာသည်:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {...},
    "resolution": "Steps to resolve the issue"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

နောက်ထပ်အကူအညီလိုပါသလား?

ကျွန်ုပ်တို့၏ API စာရွက်စာတမ်းများကိုစစ်ဆေးပါ သို့မဟုတ် သင့်အမှားကုဒ်နှင့် တောင်းဆိုမှုအသေးစိတ်များဖြင့် ဝန်ဆောင်မှုကိုဆက်သွယ်ပါ။

API အကိုးအကား

အကူအညီရယူပါ

မေးခွန်းများရှိပါသလား? ကျွန်ုပ်တို့၏စာရွက်စာတမ်းများကိုစစ်ဆေးပါ သို့မဟုတ် ဝန်ဆောင်မှုကိုဆက်သွယ်ပါ။

Console ကိုဖွင့်ပါ