Quota နှင့် Rate Limit များ

FreeMaint API သည် ကုမ္ပဏီတစ်ခုစီအတွက် UTC သန်းခေါင်ယံတွင် ပြန်လည်သတ်မှတ်သည့် နေ့စဉ် quota ကို အတည်ဖြစ်စေသည်။ ကန့်သတ်ချက်သည် သင့် tier အပေါ် မူတည်သည်; counter နှင့် ကျန်ရှိသော အရေအတွက်ကို response header များအဖြစ် ဖော်ပြထားသည်။

နေ့စဉ် ကန့်သတ်ချက်များ

• Core, Starter — 0 (API key အတွက် Business လိုအပ်သည်)
• Business — တစ်ရက်လျှင် ခေါ်ဆိုမှု 5,000 (GraphQL နှင့် စွမ်းအင်ဒေတာထည့်သွင်းသည့် endpoint တို့ တူညီသောကောင်တာကို မျှဝေသုံးသည်)
• Enterprise — တစ်ရက်လျှင် ခေါ်ဆိုမှု 100,000
• On-Premise — အကန့်အသတ်မရှိ (ကန့်သတ်ချက် = null)

Response Header များ

• X-RateLimit-Limit — သင့် tier ၏ နေ့စဉ်ကန့်သတ်ချက်
• X-RateLimit-Remaining — ယနေ့ ကျန်ရှိသော calls (quota ရေတွက်သည့် call တိုင်းတွင် လျှော့ချသည်)
• X-RateLimit-Reset — UTC သန်းခေါင်ယံ၏ Unix timestamp (နောက်ထပ် ပြန်လည်သတ်မှတ်ချိန်)

ဘာတွေက ရေမတွက်ဘူးလဲ

/public-api/whoami တစ်ခုတည်းသာ အခမဲ့ဖြစ်သည် — သင့်ကောင်တာကို မလျှော့သောကြောင့် ခွဲတမ်းမကုန်ဘဲ key နှင့် ၎င်း၏ plan ကို စစ်ဆေးနိုင်သည်။ /api/v1/graphql မှတစ်ဆင့် ဖြတ်သန်းသမျှအားလုံးကို whoami query အပါအဝင် ရေတွက်ပြီး စွမ်းအင်ဒေတာထည့်သွင်းသည့် endpoint လည်း ထို့အတူဖြစ်သည်။

ခေါ်ဆိုမှုတစ်ကြိမ်အဖြစ် မည်သည်ကို ရေတွက်သနည်း

ရေတွက်မှုသည် HTTP တောင်းဆိုမှုအလိုက် မဟုတ်ဘဲ လုပ်ဆောင်ချက်အလိုက် တိုးပါသည်။ alias ပါသော mutation ၅၀ ကို တောင်းဆိုမှုတစ်ခုတည်းတွင် စုစည်းလျှင်လည်း ယူနစ် ၅၀ ကုန်ဆဲဖြစ်သည်။ ထို့ကြောင့် စုစည်းခြင်းက ကွန်ရက်အသွားအပြန်ကို သက်သာစေသည်၊ ကုဋာကို မဟုတ်ပါ။ ပုံမှန် ချိန်ကိုက်မှုကို သက်သာစေရန် စာရင်းတစ်ခုလုံးကို ပြန်မဖတ်ဘဲ parts(updatedSince: "...") ဖြင့် ပြောင်းလဲသည်များကိုသာ ယူပါ။

ကန့်သတ်ချက်ကို ကျော်လွန်သွားသောအခါ

နေ့စဉ်ကန့်သတ်ချက်ပြည့်သွားပါက နောက်ထပ်ခေါ်ဆိုမှုတိုင်းကို 'Daily API cap reached' စာတမ်းဖြင့် ငြင်းပယ်သည်။ REST မျက်နှာပြင်များ (/public-api/ping၊ စွမ်းအင်ဒေတာထည့်သွင်းသည့် endpoint) တွင် ၎င်းမှာ HTTP 403 ဖြစ်သည်။ GraphQL တွင် HTTP status မှာ 200 ဖြစ်ပြီး ငြင်းပယ်မှုသည် errors[0].extensions.code = FORBIDDEN တွင် originalError.statusCode = 403 နှင့်အတူ ရှိသည်။ ကောင်တာသည် UTC 00:00 တွင် ပြန်လည်စတင်သည်။ ပျော့ပြောင်းကန့်သတ်ချက်၊ burst ခွင့်ပြုချက် သို့မဟုတ် မိနစ်အလိုက်ကာလ မရှိပါ — ကာလမှာ တစ်ရက်ဖြစ်သည်။