အမှားကုဒ်များနှင့် HTTP အခြေအနေကုဒ်များ
မအောင်မြင်သည့်အခါတိုင်း HTTP status နှင့်အတူ ပရိုဂရမ်က ဖတ်ရှုနိုင်သော သတ်မှတ်ကုဒ်တစ်ခု ပြန်ပေးပါသည်။ ပရိုဂရမ်တွင် ဆက်လုပ်မည့်အဆင့်ကို ကုဒ်အပေါ် မူတည်၍ ဆုံးဖြတ်ပါ။ ရှင်းလင်းချက်စာသားကို အခြေခံ၍ မဆုံးဖြတ်ပါနှင့်။ ထိုစာသားများသည် လူဖတ်ရန် ရေးထားခြင်းဖြစ်၍ အသုံးအနှုန်း ပြောင်းနိုင်ပါသည်။ ကုဒ်များကတော့ API တွင် သတ်မှတ်သဘောတူထားသည့်အတိုင်း မပြောင်းလဲဘဲ ရှိနေပါမည်။
Reseller API ပြန်ပေးနိုင်သော ကုဒ် 42 ခုလုံးကို ပြဿနာအမျိုးအစားအလိုက် စုထားပါသည်။ ကုဒ်တိုင်းတွင် လိုက်ပါလာသော HTTP status နှင့် ဖြေရှင်းရန် ပြင်ဆင်ရမည့်အချက်ကို ဖော်ပြထားပါသည်။
အထောက်အထားစစ်ဆေးခြင်း (401)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| MISSING_API_KEY | 401 | API Key လိုအပ်ပါသည်Authorization ခေါင်းစီး ပို့မထားပါ၊ သို့မဟုတ် ခေါင်းစီး၏ ပုံစံ မှားနေပါသည်။ | ဤခေါင်းစီးကို ထည့်သွင်းပါ: Authorization: Bearer <keyId>.<secret>action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_API_KEY | 401 | API Key မမှန်ကန်ပါပေးထားသော API Key သည် စနစ်တွင် လက်ရှိအသုံးပြုနိုင်သည့် မည်သည့် API Key နှင့်မျှ မကိုက်ညီပါ။ | Key ID နှင့် secret နှစ်ခုလုံး မှန်ကန်ကြောင်း စစ်ဆေးပါ။ လိုအပ်ပါက API Access ပန်နယ်မှ ကီးကို အသစ်ပြန်ထုတ်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
ခွင့်ပြုချက် (403)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| ACCOUNT_DISABLED | 403 | အကောင့်ကို ပိတ်ထားသည်ဤအမှားကုဒ်ကို ယခု ပြန်မပေးတော့ပါ။ အော်ဒါ မတင်နိုင်သော အကောင့်အတွက် ACCOUNT_FROZEN (HTTP 403) ကို ပြန်ပေးပါသည်။ | ဤအမှားကုဒ်အစား ACCOUNT_FROZEN (အကောင့် ရပ်ဆိုင်းထားခြင်း) ကို ကိုင်တွယ်ပါ။ပြန်မပေးတော့ပါ၊ ACCOUNT_FROZEN ဖြင့် အစားထိုးထားသည် |
| ACCOUNT_FROZEN | 403 | အကောင့်ကို ရပ်ဆိုင်းထားပါသည်အကောင့်ကို ယာယီ ရပ်ဆိုင်းထားပါသည်။ အများအားဖြင့် သံသယဖြစ်ဖွယ် လုပ်ဆောင်မှုကြောင့် ဖြစ်တတ်ပါသည်။ | အကောင့်ရပ်ဆိုင်းထားမှုကို ဖြေရှင်းပေးရန် Support ထံ ဆက်သွယ်ပါ။action: CONTACT_SUPPORT · retryable: false · retry_after: null |
| IP_NOT_ALLOWED | 403 | IP လိပ်စာသည် ခွင့်ပြုစာရင်းတွင် မပါဝင်ပါတောင်းဆိုမှု ပေးပို့သည့် IP လိပ်စာသည် API Key ၏ ခွင့်ပြုစာရင်းတွင် မပါဝင်ပါ။ | API Access ကဏ္ဍရှိ ခွင့်ပြုစာရင်းထဲသို့ သင့်ဆာဗာ၏ IP ကို ထည့်ပါ၊ သို့မဟုတ် IP ကန့်သတ်ချက်များကို ဖယ်ရှားပါ။action: FIX_INPUT · retryable: false · retry_after: null |
တောင်းဆိုမှု စစ်ဆေးခြင်း (400)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| MISSING_REQUIRED_FIELD | 400 | လိုအပ်သော field မပါဝင်ပါတောင်းဆိုမှု၏ body တွင် မဖြစ်မနေ ပါရမည့် အကွက်တစ်ခု မပါဝင်ပါ။ ကစားသူဆိုင်ရာ လိုအပ်ချက်များအတွက် ပျောက်နေသော အကွက်အမည်ကို details.field တွင် ဖော်ပြပါသည်။ | သက်ဆိုင်ရာ endpoint ၏ အသုံးပြုနည်းကို စစ်ဆေးပါ။ ကစားသူအချက်အလက်အတွက် လိုအပ်သော အကွက်များကို GET /catalog/category/:categoryId/requirements တွင် ကြည့်ပြီး လိုအပ်သည့် အကွက်အားလုံးကို ပေးပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_PARAMETER_FORMAT | 400 | ပါရာမီတာ တစ်ခု၏ ပုံစံ မမှန်ကန်ပါလိုအပ်ချက် အကွက်တစ်ခု၏ ပုံစံ မှားနေပါသည် (ဥပမာ နံပါတ်သာ ထည့်ရမည့် အကွက်တွင် စာသား ထည့်ထားခြင်း)။ မည်သည့်အကွက် ဖြစ်ကြောင်းကို details.field တွင် ပြပါသည်။ | အမျိုးအစား၏ လိုအပ်ချက်များကို ပြန်ဖတ်ပါ။ ထို့နောက် data_type နှင့် စစ်ဆေးမှု စည်းမျဉ်းများက သတ်မှတ်ထားသည့် ပုံစံအတိုင်း အကွက်ကို ပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_PARAMETER_VALUE | 400 | ပါရာမီတာ တစ်ခု၏ တန်ဖိုး မမှန်ကန်ပါလိုအပ်ချက်ဖြည့်ရမည့် အကွက်တစ်ခုတွင် ခွင့်မပြုထားသော တန်ဖိုး ထည့်ထားပါသည် (အနည်းဆုံးတန်ဖိုးထက် နည်းနေခြင်း၊ အများဆုံးတန်ဖိုးထက် များနေခြင်း သို့မဟုတ် select_options ထဲတွင် မပါဝင်ခြင်း)။ မည်သည့်အကွက်ဖြစ်ကြောင်း details.field တွင် ဖော်ပြထားပါသည်။ | ထိုအကွက်အတွက် အမျိုးအစားသတ်မှတ်ချက်များက ခွင့်ပြုထားသည့် တန်ဖိုးကို ပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_PARAMETER_LENGTH | 400 | ပါရာမီတာ တစ်ခု၏ အရှည် မမှန်ကန်ပါလိုအပ်ချက် အကွက်တစ်ခုသည် ခွင့်ပြုထားသည်ထက် တိုလွန်း သို့မဟုတ် ရှည်လွန်းနေပါသည်။ မည်သည့်အကွက် ဖြစ်ကြောင်းကို details.field တွင် ပြပါသည်။ | Category လိုအပ်ချက်များထဲရှိ min_length / max_length ကို စစ်ဆေးပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_UUID_FORMAT | 400 | UUID ပုံစံ မမှန်ကန်ပါအော်ဒါအတွက် ပေးပို့ထားသော order_id သည် မှန်ကန်သော UUID ပုံစံ မဟုတ်ပါ။ | မှန်ကန်သည့် UUID ပုံစံတစ်ခုခု (v1, v4, v7 စသည်) ကို သုံးပါ။ ပုံစံ: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_QUANTITY | 400 | အရေအတွက် မမှန်ကန်ပါအရေအတွက်သည် 0 ထက်ကြီးသော ကိန်းပြည့် ဖြစ်ရပါမည်။ | quantity ကို >= 1 ဖြစ်သော ကိန်းပြည့်အဖြစ် ပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_CATEGORY_ID | 400 | အမျိုးအစား ID မမှန်ကန်ပါပေးပို့သော categoryId သည် မှန်ကန်သော နံပါတ် မဟုတ်ပါ။ | အသုံးပြုနိုင်သည့် category ID များကို Catalog Explorer သို့မဟုတ် GET /catalog/categories မှ ရှာပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_BIG_CATEGORY_ID | 400 | ပင်မအမျိုးအစား ID မမှန်ကန်ပါပေးပို့ထားသည့် bigCategoryId သည် မှန်ကန်သော ကိန်းဂဏန်းမဟုတ်ပါ။ | အသုံးပြုနိုင်သည့် အမျိုးအစားကြီး ID များကို ရှာရန် Catalog Explorer သို့မဟုတ် GET /catalog/big-categories ကို အသုံးပြုပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_ITEM_ID | 400 | ပစ္စည်း ID မမှန်ကန်ပါပေးပို့သော item ID သည် မမှန်ကန်ပါ။ | အသုံးပြုနိုင်သည့် item ID များကို Catalog Explorer သို့မဟုတ် GET /catalog/subcategories မှ ရှာပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_SUBCATEGORY | 400 | အမျိုးအစားခွဲ မမှန်ကန်ပါဤအမျိုးအစားခွဲ ID မရှိပါ။ | ကတ်တလောက်ဆိုင်ရာ endpoint များကို အသုံးပြုပြီး sub_category_id မှန်ကန်ကြောင်း စစ်ဆေးပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_PRODUCT_CONFIG | 400 | ကုန်ပစ္စည်း ဆက်တင် မမှန်ကန်ပါဤအမှားကုဒ်ကို ယခု ပြန်မပေးတော့ပါ။ လိုအပ်ချက် အကွက် မပါပါက ယခုအခါ MISSING_REQUIRED_FIELD ကို ပြန်ပေးပြီး၊ လောလောဆယ် ရောင်း၍မရသော ပစ္စည်းအတွက် PRODUCT_UNAVAILABLE ကို ပြန်ပေးပါသည်။ | ယင်းအစား MISSING_REQUIRED_FIELD နှင့် PRODUCT_UNAVAILABLE အမှားများအတွက် ကိုင်တွယ်ဖြေရှင်းမှု ထည့်သွင်းပါ။ပြန်မပေးတော့ပါ၊ MISSING_REQUIRED_FIELD ဖြင့် အစားထိုးထားသည် |
| INVALID_PAGINATION | 400 | စာမျက်နှာ ပါရာမီတာများ မမှန်ကန်ပါpage သို့မဟုတ် limit တန်ဖိုးသည် ခွင့်ပြုထားသော အပိုင်းအခြားအတွင်း မရှိပါ။ | page ကို 1 နှင့်အထက်၊ limit ကို 1 မှ 100 အတွင်း သတ်မှတ်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| INVALID_DATE_FORMAT | 400 | ရက်စွဲပုံစံ မမှန်ကန်ပါcreated_after သို့မဟုတ် created_before parameter သည် မှန်ကန်သည့် ISO 8601 ရက်စွဲပုံစံ မဟုတ်ပါ။ | ရက်စွဲကို 2024-01-01T00:00:00Z ကဲ့သို့ ISO 8601 ပုံစံဖြင့် ထည့်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
ကစားသူ စစ်ဆေးခြင်း (400 / 429 / 503)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| PLAYER_NOT_FOUND | 400 | ကစားသူ ရှာမတွေ့ပါဤ Player ID မရှိကြောင်း ဂိမ်းဘက်မှ အတည်ပြုထားပါသည်။ အတည်ပြုချက် ရရှိမှသာ ဤကုဒ်ကို ပြန်ပေးသည်။ ID ကို စစ်ဆေး၍ မရသည့်အခါ PLAYER_CHECK_UNAVAILABLE ကို ပြန်ရပါမည်။ | Player ID မှန်မမှန် စစ်ဆေးပါ။ ဂိမ်းအတွက် zone_id လိုအပ်ခြင်း ရှိမရှိကိုလည်း ကြည့်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| PLAYER_CHECK_UNAVAILABLE | 503 | ဤဂိမ်းအတွက် Player ID များကို ယခု စစ်ဆေး၍ မရပါလောလောဆယ် ဤဂိမ်း၏ Player ID များကို စစ်ဆေး၍ မရပါ။ Player ID ကို ပယ်ချထားခြင်း မဟုတ်ပါ။ | retry_after စက္ကန့် စောင့်ပြီးနောက် တူညီသော request ကို ထပ်ပို့ပါ။ ID မှားနေသည်ဟု ဖောက်သည်ကို မပြောပါနှင့်။action: RETRY_LATER · retryable: true · retry_after: 60 |
| PLAYER_BUSY | 429 | ဤ Player ID ကို စစ်ဆေးနေဆဲ ဖြစ်ပါသည်တူညီသော Player ID အတွက် အခြား request တစ်ခုကို စစ်ဆေးနေဆဲ ဖြစ်ပါသည်။ | retry_after တွင် ပြထားသည့် စက္ကန့်အရေအတွက် စောင့်ပြီးမှ တောင်းဆိုမှုကို ထပ်ပို့ပါ။action: RETRY_SOON · retryable: true · retry_after: 5 |
| PLAYER_VALIDATION_FAILED | 400 | ကစားသူ အတည်ပြုခြင်း မအောင်မြင်ပါဤ error ကို ပြန်မပို့တော့ပါ။ လက်ရှိ စစ်ဆေး၍မရသည့် Player ID အတွက် PLAYER_CHECK_UNAVAILABLE (HTTP 503) ကို ပြန်ပို့ပါသည်။ | ယင်းအစား PLAYER_CHECK_UNAVAILABLE အတွက် ကိုင်တွယ်မှုကို ထည့်သွင်းပါ။ပြန်မပေးတော့ပါ၊ PLAYER_CHECK_UNAVAILABLE ဖြင့် အစားထိုးထားသည် |
| REGION_MISMATCH | 400 | ဤကစားသူ၏ Region တွင် ဤပစ္စည်းကို လက်ခံ၍ မရပါကစားသူ၏ Region သို့ ဤပစ္စည်းကို ပေးပို့၍ မရပါ။ အမှားတုံ့ပြန်ချက်တွင် player_region နှင့် player_name တို့ ပါဝင်ပါသည်။ | ကစားသူ၏ Region နှင့် ကိုက်ညီသော ပစ္စည်းကို ရွေးပါ။action: CHOOSE_OTHER · retryable: false · retry_after: null |
လုပ်ငန်းစည်းမျဉ်းများ (400 / 409)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| INSUFFICIENT_BALANCE | 400 | Wallet လက်ကျန်ငွေ မလုံလောက်ပါဤအော်ဒါ ပြီးစီးရန် Wallet ထဲတွင် ငွေ မလုံလောက်ပါ။ | အော်ဒါ မတင်မီ Reload စာမျက်နှာမှ Wallet ကို Top Up လုပ်ပါ။action: TOP_UP · retryable: false · retry_after: null |
| OUT_OF_STOCK | 400 | ပစ္စည်း Stock ပြတ်နေပါသည်တောင်းဆိုထားသော ပစ္စည်းသည် လောလောဆယ် Stock ပြတ်နေပါသည်။ | နောက်မှ ထပ်စမ်းကြည့်ပါ၊ သို့မဟုတ် အခြားပစ္စည်းကို ရွေးပါ။action: RETRY_LATER · retryable: true · retry_after: null |
| INSUFFICIENT_STOCK | 400 | တောင်းဆိုထားသည်ထက် ရနိုင်သော အရေအတွက် နည်းနေပါသည်အော်ဒါတွင် တောင်းထားသည့် အရေအတွက်ထက် ရနိုင်သည့် အရေအတွက် နည်းနေပါသည်။ OUT_OF_STOCK နှင့် မတူဘဲ ဤ error ကို ပြင်ဆင်၍ ရပါသည်။ error.max_quantity သည် ယခု မှာယူနိုင်သော အရေအတွက် ဖြစ်သည်။ ငွေ လုံးဝ မဖြတ်ထားပါ။ | အရေအတွက်ကို error.max_quantity သို့မဟုတ် ယင်းထက်နည်းအောင် ပြင်ပြီး အော်ဒါကို ထပ်ပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| PRODUCT_UNAVAILABLE | 409 | ဤပစ္စည်းကို ယာယီ ဝယ်၍ မရပါပစ္စည်းရှိသော်လည်း လောလောဆယ် ရောင်းချ၍ မရပါ။ | နောက်မှ ထပ်စမ်းကြည့်ပါ၊ သို့မဟုတ် အခြားပစ္စည်းကို ရွေးပါ။action: RETRY_LATER · retryable: true · retry_after: null |
| PRICING_UPDATING | 409 | ပစ္စည်းဈေးနှုန်းကို အပ်ဒိတ်လုပ်နေပါသည်ဒီပစ္စည်းရဲ့ ဈေးနှုန်းကို ပြန်တွက်နေပါတယ်။ | retry_after တွင် ပြထားသည့် စက္ကန့်အရေအတွက် ကြာပြီးနောက် တူညီသော တောင်းဆိုမှုကို ထပ်ပို့ပြီး ဈေးနှုန်းကို ပြန်စစ်ပါ။action: RETRY_SOON · retryable: true · retry_after: 30 |
| OFFER_NOT_FOUND | 400 | ဤ Offer ကို ဤကစားသူ အကောင့်တွင် ဝယ်၍ မရပါတစ်ကြိမ်သာ ရနိုင်သော Offer (ဥပမာ ပထမဆုံး Top Up bonus) ကို ဤကစားသူ အကောင့်တွင် ဝယ်၍ မရပါ။ အသုံးပြုပြီးသား ဖြစ်နိုင်ပါသည်။ | ဤကစားသူအတွက် အခြားပစ္စည်းကို ရွေးပါ။action: CHOOSE_OTHER · retryable: false · retry_after: null |
| DUPLICATE_ORDER | 409 | အော်ဒါ ID ထပ်နေပါသည်ဤ UUID ဖြင့် အော်ဒါရှိပြီးသားဖြစ်ပါသည်။ UUID တူညီသည့် အော်ဒါကို ထပ်မံမဖန်တီးစေရန် ကာကွယ်ထားခြင်းဖြစ်ပါသည်။ | အော်ဒါအသစ်အတွက် UUID အသစ် ထုတ်ပါ။ ထပ်ပို့စဉ် ဤ error ရပါက ပထမအကြိမ် ပို့ထားသော အော်ဒါကို လက်ခံရရှိပြီး ဖြစ်သည်။ အော်ဒါအသစ် ထပ်မတင်ဘဲ GET /orders/{orderId} ဖြင့် ထိုအော်ဒါကို ဖတ်ပါ။action: CHECK_ORDER · retryable: false · retry_after: null |
| PRICE_INCREASED | 400 | ဈေးနှုန်း မျှော်မှန်းထားသည်ထက် တက်သွားပါသည်လက်ရှိ တစ်ခုချင်း ဈေးနှုန်းသည် တောင်းဆိုမှုတွင် ပါသော expected_unit_price ထက် မြင့်နေပါသည်။ | GET /catalog/subcategory/:id/price ဖြင့် နောက်ဆုံးဈေးနှုန်းကို ရယူပြီး expected_unit_price ကို ပြင်ဆင်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| SUBCATEGORY_DISABLED | 400 | အမျိုးအစားခွဲကို ပိတ်ထားပါသည်ဤကုဒ်ကို နောက်ထပ် ပြန်မပေးတော့ပါ။ လောလောဆယ် ရောင်းချ၍ မရသော ပစ္စည်းအတွက် PRODUCT_UNAVAILABLE (HTTP 409) ဖြင့် ပြန်ဖြေပါသည်။ | ဤအမှားကုဒ်ကို သီးခြား ကိုင်တွယ်ရန် မလိုပါ။ ယင်းအစား PRODUCT_UNAVAILABLE ကို စစ်ဆေးကိုင်တွယ်ပေးပါ။ပြန်မပေးတော့ပါ၊ PRODUCT_UNAVAILABLE ဖြင့် အစားထိုးထားသည် |
ရှာမတွေ့ပါ (404)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| ORDER_NOT_FOUND | 404 | အော်ဒါ ရှာမတွေ့ပါပေးထားသော အော်ဒါ ID ဖြင့် အော်ဒါ မရှိပါ။ | အော်ဒါ ID မှန်မမှန် စစ်ဆေးပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| ITEM_NOT_FOUND | 404 | ပစ္စည်း ရှာမတွေ့ပါတောင်းဆိုထားသော ပစ္စည်းသည် ပစ္စည်းစာရင်းတွင် မရှိပါ။ | မှန်ကန်သော ပစ္စည်း ID များကို ပစ္စည်းစာရင်းဆိုင်ရာ endpoint များဖြင့် ရှာဖွေပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| NO_REQUIREMENTS_FOUND | 404 | ဤ အမျိုးအစား အတွက် လိုအပ်ချက် မတွေ့ပါဤ အမျိုးအစား တွင် လောလောဆယ် ပြန်ပေးစရာ ကစားသူ လိုအပ်ချက် မရှိပါ။ | နောက်မှ ထပ်စမ်းကြည့်ပါ၊ သို့မဟုတ် အခြား အမျိုးအစား ကို ရွေးပါ။action: RETRY_LATER · retryable: true · retry_after: null |
| ITEM_NOT_AVAILABLE | 404 | ပစ္စည်း မရရှိနိုင်ပါဤကုဒ်ကို နောက်ထပ် ပြန်မပေးတော့ပါ။ ရှိသော်လည်း လောလောဆယ် ရောင်းချ၍ မရသော item အတွက် PRODUCT_UNAVAILABLE (HTTP 409) ဖြင့် ပြန်ဖြေပါသည်။ | ဤအမှားကုဒ်ကို သီးခြား ကိုင်တွယ်ရန် မလိုပါ။ ယင်းအစား PRODUCT_UNAVAILABLE ကို စစ်ဆေးကိုင်တွယ်ပေးပါ။ပြန်မပေးတော့ပါ၊ PRODUCT_UNAVAILABLE ဖြင့် အစားထိုးထားသည် |
အစုလိုက် တောင်းဆိုမှု စစ်ဆေးခြင်း (400)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| INVALID_ORDER_IDS_FORMAT | 400 | အော်ဒါနံပါတ်စာရင်း (order_ids) ပုံစံ မမှန်ကန်ပါorder_ids အကွက်သည် အော်ဒါ ID တစ်ခုချင်းကို စာသားအဖြစ် ထည့်ထားသော array ဖြစ်ရပါမည်။ | တောင်းဆိုမှုတွင် အော်ဒါနံပါတ်များကို စာရင်းတစ်ခုအဖြစ် စုစည်းပြီး အောက်ပါပုံစံအတိုင်း တိတိကျကျ ပို့ပေးပါ: { "order_ids": ["uuid1", "uuid2"] }။action: FIX_INPUT · retryable: false · retry_after: null |
| EMPTY_ORDER_IDS | 400 | အော်ဒါနံပါတ်စာရင်း (order_ids) ဗလာ ဖြစ်နေပါသည်order_ids စာရင်းတွင် အော်ဒါနံပါတ် အနည်းဆုံး တစ်ခု ပါရပါမည်။ | array ထဲတွင် အော်ဒါ ID အနည်းဆုံး တစ်ခု ထည့်ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
| TOO_MANY_ORDER_IDS | 400 | အော်ဒါ ID များလွန်းနေပါသည်တစ်ကြိမ်လျှင် အော်ဒါ ID အများဆုံး 50 ခုအထိသာ query လုပ်နိုင်ပါသည်။ | request ကို 50 ခု သို့မဟုတ် ယင်းထက်နည်းသည့် batch များအဖြစ် ခွဲပို့ပါ။action: FIX_INPUT · retryable: false · retry_after: null |
တောင်းဆိုမှုနှုန်း ကန့်သတ်ခြင်း (429)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| RATE_LIMIT_EXCEEDED | 429 | တောင်းဆိုမှု အကြိမ်ရေ ကန့်သတ်ချက် ကျော်သွားပါပြီဤ endpoint အတွက် သတ်မှတ်ထားသည့် အသုံးပြုခွင့်အကြိမ်ရေကို ကျော်လွန်သွားပါပြီ။ ကုန်ပစ္စည်းစာရင်း၊ အော်ဒါနှင့် အကောင့်ဆိုင်ရာ တောင်းဆိုမှုအုပ်စုများအတွက် တစ်မိနစ်အလိုက် ကန့်သတ်ချက်ကို သတ်မှတ်ထားပြီး တုံ့ပြန်ချက်တိုင်းတွင် X-RateLimit-Limit၊ X-RateLimit-Remaining နှင့် X-RateLimit-Reset တို့ကို ပေးပို့ပါသည်။ details တွင်လည်း limit၊ remaining (0)၊ retry_after နှင့် window_seconds တို့ကို ထပ်မံဖော်ပြထားပါသည်။ POST /player/validate အတွက်မူ နေ့စဉ် ကစားသူအချက်အလက် စစ်ဆေးခွင့်အကြိမ်ရေဖြင့် တွက်ချက်ပါသည်။ ထို့ကြောင့် X-RateLimit header များကို မပေးပို့ဘဲ 429 တုံ့ပြန်ချက်၏ error အတွင်း၌ limit၊ current၊ remaining၊ reset_at နှင့် reset_in_seconds တို့ကို ဖော်ပြထားပါသည်။ မည်သည့်ကန့်သတ်ချက်ကြောင့် ဖြစ်ပေါ်သည်ဖြစ်စေ စောင့်ဆိုင်းရမည့်အချိန်ကို စက္ကန့်ဖြင့် error.retry_after နှင့် Retry-After header တွင် ဖော်ပြထားပါသည်။ | ထပ်မံမပို့မီ retry_after သို့မဟုတ် Retry-After header တွင် ဖော်ပြထားသည့် စက္ကန့်အရေအတွက်အတိုင်း စောင့်ပါ။ တစ်မိနစ်အလိုက် ကန့်သတ်ထားသည့် endpoint များတွင် ကန့်သတ်ချက်မပြည့်စေရန် X-RateLimit-Remaining ကို ကြည့်ပြီး ကျန်ရှိသည့် အကြိမ်ရေကို စစ်ဆေးပါ။action: RETRY_LATER · retryable: true · retry_after: စောင့်ဆိုင်းရန် ကျန်ရှိသည့် စက္ကန့် |
Server ဘက်ဆိုင်ရာ (5xx)
| ကုဒ် | အခြေအနေ ကုဒ် | အဓိပ္ပာယ် | ပြင်ဆင်နည်း |
|---|---|---|---|
| INTERNAL_ERROR | 500 | Server အတွင်းပိုင်း အမှားServer တွင် မမျှော်လင့်ထားသော အမှားတစ်ခု ဖြစ်ပေါ်ခဲ့ပါသည်။ | retry_after စက္ကန့် ကြာပြီးမှ တောင်းဆိုမှုကို ထပ်ပို့ပါ။ POST /orders/create ဆိုလျှင် ယခင် order_id ကိုပင် ပြန်သုံးပါ၊ သို့မှသာ အော်ဒါကို နှစ်ကြိမ် ဖန်တီးမိခြင်း လုံးဝ မဖြစ်နိုင်ပါ။ ပြဿနာ မပြေလည်သေးပါက အကူအညီအဖွဲ့ကို ဆက်သွယ်ပါ။action: RETRY_LATER · retryable: true · retry_after: 30 |
| SERVICE_UNAVAILABLE | 503 | ဝန်ဆောင်မှုကို ယာယီ အသုံးမပြုနိုင်ပါယခုအခါ ဤကုဒ်ကို ပြန်မပို့တော့ပါ။ ဆာဗာဘက် ချို့ယွင်းချက်ဖြစ်ပါက INTERNAL_ERROR (HTTP 500) ဖြင့် ပြန်ဖြေသည်။ 503 ကို PLAYER_CHECK_UNAVAILABLE အတွက်သာ သုံးပြီး ကစားသူ ID ကို လောလောဆယ် စစ်ဆေး၍ မရသည့်အခါ ပြန်ပို့ပါသည်။ | ဤအမှားကုဒ်ကို စစ်မည့်အစား စနစ်မှ ပြန်ပေးနိုင်သော INTERNAL_ERROR နှင့် PLAYER_CHECK_UNAVAILABLE အမှားကုဒ်နှစ်မျိုးကို သင့်ပရိုဂရမ်ဘက်မှ မှန်ကန်စွာ ကိုင်တွယ်နိုင်အောင် ပြင်ဆင်ထားပါ။ပြန်မပေးတော့ပါ၊ INTERNAL_ERROR ဖြင့် အစားထိုးထားသည် |
ပလက်ဖောင်းကို စတင်အသုံးပြုသူ ဖြစ်ပါက Reseller များအတွက် ဂိမ်း Top Up API အကျဉ်းချုပ်၊ သို့မဟုတ် SHOP2TOPUP Reseller အစီအစဉ် အကျဉ်းချုပ် ကို ဖတ်၍ ပါတနာအကောင့် မည်သို့ အလုပ်လုပ်သည်ကို လေ့လာပါ။