နေ့ 0
အသုံးပြုခွင့်ကို သက်သေပြပါ
Key ကို ဖန်တီးပါ၊ authenticated request တစ်ခုကို အပြီးသတ်ပါ၊ ပြီးလျှင် ပထမဆုံး response ကို ၎င်း၏ metadata နှင့်အတူ သိမ်းဆည်းပါ။
အဆင့်ကို ဖွင့်ပါ →API လုပ်ငန်းစဉ် လမ်းညွှန်
သင် ဘာတည်ဆောက်ချင်ပါသလဲ။
သင်၏ အလုပ်နှင့် အနီးစပ်ဆုံး ရလဒ်ကို ရွေးချယ်ပါ။ လမ်းကြောင်းတစ်ခုစီသည် လုပ်ဆောင်နိုင်သော တောင်းဆိုမှုတစ်ခု၊ တုံ့ပြန်မှုတွင် ဘာပါဝင်သင့်သည်၊ ၎င်း အလုပ်လုပ်ခြင်း ရှိမရှိ မည်သို့စစ်ဆေးရမည်နှင့် နောက်ထပ် အသုံးဝင်သော အဆင့်တို့ကို ပေးပါသည်။
လက်တွေ့ကျသော လမ်းကြောင်းငါးခု
endpoint စာရင်းမှ မဟုတ်ဘဲ ရလဒ်မှ စတင်ပါ။
Selected: Harden a client
လမ်းကြောင်း 1
မက်ခရိုဒေတာကို ရယူပါ
သန့်စင်သော time series တစ်ခုကို ရယူပြီး ၎င်းနှင့်အတူ source နှင့် quality metadata များကို သိမ်းဆည်းထားပါ။
လမ်းကြောင်း 2
ထုတ်ပြန်မှု အလုပ်များကို စီစဉ်ပါ
သိရှိပြီးသော ထုတ်ပြန်ချိန်များတွင် ပစ်မှတ်ထားသော အလုပ်များကို လုပ်ဆောင်ရန် release ပြက္ခဒိန်ကို အသုံးပြုပါ။
လမ်းကြောင်း 3
အံ့အားသင့်မှုများကို တိုင်းတာပါ
lookahead bias မဖြစ်စေဘဲ ထုတ်ပြန်ထားသော တန်ဖိုးသို့ pre-release ခန့်မှန်းချက်များကို ပေါင်းစပ်ပါ။
လမ်းကြောင်း 4
live updates များကို လက်ခံရယူပါ
SSE ကို ပယ်ဖျက်မှုအချက်ပြမှုအဖြစ် အသုံးပြုပါ၊ ထို့နောက် REST မှ ပြည့်စုံသော မှတ်တမ်းကို ရယူပါ။
လမ်းကြောင်း 5
မက်ခရိုမော်ဒယ်တစ်ခု တည်ဆောက်ပါ
ဆက်စပ်နေသော ညွှန်းကိန်းအုပ်စုငယ်တစ်ခုကို ရင်းမြစ်အညွှန်းတပ်ထားသော ငွေကြေးရမှတ်စာရင်းတစ်ခုအဖြစ် ပြောင်းလဲပါ။
သင်၏ 14 ရက် API စမ်းသပ်ကာလ
ပထမဆုံး တောင်းဆိုမှုမှသည် တန်ဖိုးရှိသော အလုပ်တစ်ခုသို့ ကူးပြောင်းပါ။
ရည်မှန်းချက်မှာ ထုတ်ကုန်စာမျက်နှာတိုင်းသို့ သွားရောက်ရန် မဟုတ်ပါ။ အသုံးဝင်သော စစ်ဆေးအတည်ပြုပြီးသား API အလုပ်ကို ပြီးမြောက်စေရန်၊ အခြားနေ့တွင် ပြန်လာရန်နှင့် ထပ်ခါတလဲလဲ အသုံးပြုနိုင်သော dataset သို့မဟုတ် application လုပ်ငန်းစဉ်တစ်ခုဖြင့် ထွက်ခွာရန် ဖြစ်သည်။
ရက်များ 1-2
တောင်းဆိုချက်ကို ယုံကြည်စိတ်ချရအောင် ပြုလုပ်ပါ
စစ်ဆေးအတည်ပြုခြင်း သို့မဟုတ် filter ပြဿနာများကို ဖြေရှင်းပြီး ပထမဆုံး script ကို အမည်ပေးထားသော ထပ်ခါတလဲလဲ လုပ်ဆောင်နိုင်သည့် အလုပ်တစ်ခုအဖြစ် ပြောင်းလဲပါ။
အဆင့်ကို ဖွင့်ပါ →ရက် 3-4
ထုတ်ပြန်မှုအချိန်ကို ထည့်သွင်းပါ
ပြက္ခဒိန်ကို ဒုတိယ endpoint မိသားစုအဖြစ် အသုံးပြုပြီး နောက်ထပ် အသုံးဝင်မည့် API လုပ်ဆောင်ချက်ကို အချိန်ဇယားဆွဲပါ။
အဆင့်ကို ဖွင့်ပါ →ရက်ပေါင်း 5-7
သုတေသနရလဒ်ကို တည်ဆောက်ပါ
မျှော်မှန်းချက်များ သို့မဟုတ် မက်ခရိုစီးရီး အုပ်စုငယ်တစ်ခုကို ထည့်ပါ၊ ထို့နောက် သိမ်းဆည်းထားသော နှိုင်းယှဉ်ချက်၊ ဇယား သို့မဟုတ် ရမှတ်စာရင်းတစ်ခုကို ထုတ်ပေးပါ။
အဆင့်ကို ဖွင့်ပါ →ရက်များ 8-10
အပ်ဒိတ်များကို အလိုအလျောက်ပြုလုပ်ပါ
သတ်မှတ်ထားသော REST, SSE, သို့မဟုတ် webhooks များကို ရွေးချယ်ပြီး အခြားနေ့တစ်နေ့တွင် နောက်ထပ် အောင်မြင်သော API run တစ်ခုကို ပြီးမြောက်အောင် လုပ်ဆောင်ပါ။
အဆင့်ကို ဖွင့်ပါ →ရက်စွဲများ 11-13
Client ကို ပိုမိုခိုင်မာစေပါ
timeouts များ၊ ကန့်သတ်ထားသော ပြန်ကြိုးစားမှုများ၊ တုံ့ပြန်မှု အတည်ပြုခြင်း၊ လုံခြုံသော credential logging နှင့် ဟောင်းနွမ်းသော ဒေတာ စောင့်ကြည့်မှုများကို ထည့်သွင်းပါ။
အဆင့်ကို ဖွင့်ပါ →နေ့ရက် 14
အထောက်အထားများကို ပြန်လည်သုံးသပ်ပါ
API သည် သင့်အဖွဲ့ ဆက်လက်ထိန်းသိမ်းမည့် ထပ်ခါတလဲလဲ လုပ်ဆောင်နိုင်သော အလုပ်တစ်ခုကို ပံ့ပိုးပေးကြောင်း အတည်ပြုပါ၊ ထို့နောက် နောက်ထပ် dataset သို့မဟုတ် application workflow ကို ရွေးချယ်ပါ။
အဆင့်ကို ဖွင့်ပါ →Production readiness
API client ကို ထုတ်လုပ်မှုအဆင့် အဆင်သင့်ဖြစ်အောင် ပြုလုပ်ပါ
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
လက်တွေ့အသုံးပြုပုံ ဥပမာ
သင်၏ key ကို ဤနေရာတွင် ထားပါ FXMD_API_KEY; ၎င်းကို source control ထဲသို့ မည်သည့်အခါမျှ paste မလုပ်ပါနှင့်။
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()မျှော်မှန်းထားသော ရလဒ်: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
ပထမဆုံး script သည် စနစ်အစစ်အမှန် ဖြစ်လာသောအခါ
ပြဿနာဖြေရှင်းခြင်းနှင့် ထုတ်လုပ်မှု လမ်းညွှန်ချက်
တုံ့ပြန်မှု ပျက်ကွက်ခြင်း၊ ဒေတာမရှိခြင်း သို့မဟုတ် caching, timeouts, retries နှင့် event delivery ကဲ့သို့သော production controls များ လိုအပ်သောအခါ ဤလမ်းညွှန်များကို အသုံးပြုပါ။
| လမ်းညွှန် | ၎င်းကို အသုံးပြုပါ | စတင်ပါ |
|---|---|---|
| ပျက်ကွက်သော သို့မဟုတ် အလွတ်ဖြစ်နေသော တုံ့ပြန်မှုကို ရှာဖွေဖော်ထုတ်ပါ | သင်၏ key ကို မဖော်ပြဘဲ စစ်ဆေးအတည်ပြုခြင်း၊ အသုံးပြုခွင့်၊ လမ်းကြောင်း၊ rate-limit နှင့် ဒေတာရရှိနိုင်မှု ပြဿနာများကို သီးခြားခွဲထုတ်ပါ။ | လမ်းညွှန်ကို ဖွင့်ပါ → |
| API client ကို ထုတ်လုပ်မှုအဆင့် အဆင်သင့်ဖြစ်အောင် ပြုလုပ်ပါ | timeouts၊ ကန့်သတ်ထားသော retries၊ caching၊ conditional requests နှင့် မှန်ကန်သော ပေးပို့မှုပုံစံကို ထည့်သွင်းပါ။ | လမ်းညွှန်ကို ဖွင့်ပါ → |