ဆော့ဖ်ဝဲရေးသားသူများအတွက်

ကုဒ်မှတစ်ဆင့် သင်ကိုယ်တိုင် စီမံဖန်တီးနိုင်သော ဟိုစတင်င်မ်ဝန်ဆောင်မှု

Zinn Digital® သည် API-first ပလပ်ဖောင်းတစ်ခု ဖြစ်ပါသည်။ ကျွန်ုပ်တို့၏ ဒက်ရှ်ဘုတ်ကို စွမ်းဆောင်ပေးနေသော အင်ဂျင် API တူညီချက်ကိုပင် သင်ရရှိမည်ဖြစ်သည် — ဗားရှင်းသတ်မှတ်ထားပြီး၊ spec-first ဖြစ်ကာ တည်ဆောက်ချိန်တွင် ၁၀၀ ရာခိုင်နှုန်း စာရွက်စာတမ်းပြုစုထားပြီး၊ ထုတ်လုပ်ထားသော SDK များ၊ CLI တစ်ခု၊ Terraform ပံ့ပိုးပေးသူတစ်ဦး၊ လက်မှတ်ထိုးထားသော ဝဘ်ဟွတ်များနှင့် ၎င်း၏အပေါ်တွင် MCP ဆာဗာတစ်ခုတို့ ပါဝင်ပါသည်။ သင်အလုပ်လုပ်ရန် အသုံးပြုသည်ဖြစ်စေ — တာမီနယ်၊ ပိုက်လိုင်း၊ အခြေအနေဖိုင် သို့မဟုတ် AI အေးဂျင့် — ပလပ်ဖောင်းက ၎င်းတို့အားလုံးကို တုံ့ပြန်ဆောင်ရွက်ပေးပါသည်။

  • ၆၅၀,၀၀၀+ကမ္ဘာတစ်ဝှမ်းတွင် ဟို့စ်တင်းလုပ်ထားသော ဆိုက်များ
  • ကိရိယာတိုင်းကို ထုတ်ပေးသည့် OpenAPI spec
  • သုံးစွဲသူ SDKများ — TypeScript၊ Python၊ PHP၊ Go
  • OAuth 2.1နယ်ပယ်သတ်မှတ်ထားသော၊ ပြန်လည်ရုပ်သိမ်းနိုင်သော AI-ကိုယ်စားလှယ် အသုံးပြုခွင့်

API တစ်ခု။ မျက်နှာပြင်တိုင်းက ၎င်းကို အသုံးပြုသည်။

ဝဘ်ဟိုစ်အများစုက ထိန်းချုပ်ဝင်းဒိုးပေါ်မှာ API ကို နောက်မှတပ်ဆင်ကြတာမို့ အားနည်းချက်တွေပေါ်လွင်နေပြီး ဝင်းဒိုးရဲ့ လုပ်ဆောင်ချက်တစ်ဝက်လောက်က အပြင်ကိုမရောက်လာပါဘူး။ ကျွန်တော်တို့ကတော့ ပြောင်းပြန်ပုံစံနဲ့ တည်ဆောက်ခဲ့တာပါ။ ဒက်ရှ်ဘုတ်၊ အက်မင်ကွန်ဆိုးလ်၊ CLI၊ Terraform ပံ့ပိုးပေးသူ၊ MCP ဆာဗာနဲ့ သင့်ရဲ့ကိုယ်ပိုင်ပေါင်းစပ်မှုတွေအားလုံးဟာ အင်ဂျင် API တစ်ခုတည်းကိုပဲ အသုံးပြုကြပါတယ်။ အကယ်၍ ဒါကို ဝင်းဒိုးမှာ လုပ်ဆောင်နိုင်တယ်ဆိုရင် ကုဒ်နဲ့လည်း လုပ်ဆောင်နိုင်ပါတယ်။

သတ်မှတ်ချက်-ဦးစားပေး၊ နောက်မှစာရွက်စာတမ်းတင်သည်မဟုတ်ပါ

OpenAPI သတ်မှတ်ချက်သည် အဓိကအချက်အလက်ရင်းမြစ်ဖြစ်ပြီး၊ သတ်မှတ်ချက်ထဲတွင်မပါဝင်ပါက မည်သည့်အမှတ်ဆုံမှ ထွက်ရှိမည်မဟုတ်ပါ။ ဤစည်းမျဉ်းတစ်ခုတည်းကပင် အများပြည်သူသုံး API ကို နောင်တစ်ချိန်တွင် မဟုတ်ဘဲ တည်ဆောက်ချိန်တွင်ပင် အပြည့်အစုံ မှတ်တမ်းတင်ထားနိုင်စေရန် ပြုလုပ်ပေးသည် — မှတ်တမ်းမတင်ထားသော အစွန်အဖျားဟူ၍ မရှိပါ၊ အကြောင်းမှာ မှတ်တမ်းမတင်ထားသော အမှတ်ဆုံဟူ၍ မရှိနိုင်သောကြောင့်တည်း။

ထုတ်လုပ်ပြီး၊ လက်ဖြင့်ထိန်းသိမ်းခြင်းမရှိပါ

တုံ့ပြန်မှုပေးနိုင်သော ကိုးကားချက် စာရွက်စာတမ်းများ၊ သုံးစွဲသူဆိုင်ရာ SDK လေးခု၊ CLI ၏ အစိတ်အပိုင်းအများအပြားနှင့် Terraform ပံ့ပိုးပေးသူ၏ အဆောက်အအုံတို့ကို အဆိုပါ သတ်မှတ်ချက်တစ်ခုတည်းမှ ထုတ်လုပ်ထားခြင်းဖြစ်သည်။ ပင်ရင်းတစ်ခုတည်းမှ ထုတ်ကုန်များစွာကို အမြဲတမ်း တစ်ပြိုင်တည်း ဖြစ်စေသည် — အကောင်အထည်ဖော်မှုနှင့် လွဲချော်သွားသည့် စာရွက်စာတမ်းများနောက်သို့ သင် မည်သည့်အခါမျှ လိုက်ရှာစရာ မလိုတော့ပါ။

ထုတ်ပယ်ရေးမူဝါဒဖြင့် ဗားရှင်းသတ်မှတ်ထားသည်

/v1 အောက်တွင် အဆုံးသတ်ဖျက်သိမ်းခြင်းဆိုင်ရာ မူဝါဒနှင့် ပြောင်းလဲမှုမှတ်တမ်းတို့ ပါရှိသော အမှတ်အသားများကို ထားရှိပါသည်။ တစ်စုံတစ်ရာ ပြောင်းလဲတော့မည်ဆိုပါက ပျက်စီးနေသော တည်ဆောက်မှုတစ်ခုမှတစ်ဆင့် သိရှိရသည်ထက် စာဖြင့် ကြိုတင်အကြောင်းကြားခြင်းကို သင်ရရှိမည်ဖြစ်သည်။

CI တွင် စာချုပ်စစ်ဆေးပြီးပါပြီ

ပြောင်းလဲမှုတိုင်းတွင် Implementation-versus-spec contract tests များနှင့် OpenAPI linting တို့ကို လုပ်ဆောင်ပေးပါသည်။ ကုဒ်နှင့် contract အကြား ကွာဟချက်ရှိပါက build ကို ပျက်စေမည်ဖြစ်ရာ — သင့် client ကို ထုတ်ယူဖန်တီးပေးသည့် spec မှာ server က အမှန်တကယ် လက်ခံအသုံးပြုနေသည့် spec ပင် ဖြစ်ပါသည်။

ခွင့်ပြုချက်၊ နယ်ပယ်သတ်မှတ်ခြင်းနှင့် ကြီးမားသောစကေးတွင် ကြုံတွေ့ရတတ်သော ပြဿနာများ

ဝင်ရောက်ရန် နည်းလမ်းနှစ်ခု ရှိသော်လည်း ၎င်းတို့နောက်ကွယ်တွင် တူညီသော မူဝါဒတစ်ခုတည်း ရှိပါသည်။ သင်မည်သည့်နည်းလမ်းကို အသုံးပြုသည်ဖြစ်စေ တူညီသော ခွင့်ပြုချက်စစ်ဆေးမှုများနှင့် တူညီသော ဒေတာဘေ့စ်အဆင့် သီးခြားခွဲထုတ်မှုတို့ အကျုံးဝင်ပါသည်။

အဖွဲ့အစည်းတစ်ခုစီအတွက် API ခော့များ

သော့များ၏ ပုံစံမှာ zdk_<mode>_<prefix>_<secret> ဖြစ်သည်။ လျှို့ဝှက်ချက်၏ SHA-256 ဟတ်ချ် (hash) ကိုသာ သိမ်းဆည်းထားပြီး - သော့ကို ထုတ်ပေးပြီးနောက် ကျွန်ုပ်တို့အနေဖြင့် ၎င်းကို ပြန်လည်မပြသနိုင်သလို ကျွန်ုပ်တို့၏ဒေတာဘေ့စ်သို့ ဝင်ရောက်နိုင်သူတိုင်းလည်း မပြသနိုင်ပါ။ သော့များတွင် နယ်ပယ်အစုံ (scopes) ပါရှိပြီး၊ ပယ်ဖျက်နိုင်ကာ လူတစ်ဦးချင်းစီအလိုက်ထက် အဖွဲ့အစည်းအလိုက် ထုတ်ပေးပါသည်။

တိုက်ရိုက်လွှင့်ခြင်း (Live) နှင့် စမ်းသပ်ခြင်း (test) မုဒ်များကို သီးခြားစီ ထိန်းသိမ်းထားသည်

Sandbox ကီးများသည် ထုတ်လုပ်မှု (production) ကီးများနှင့် သီးခြားစီဖြစ်ပြီး sandbox မုဒ်တွင် အလုပ်လုပ်ပါသည်- အမှန်တကယ် ငွေတောင်းခံခြင်းမရှိ၊ အမှန်တကယ် ဝန်ဆောင်မှုပြင်ဆင်ပေးခြင်းမရှိပါ။ သင်၏ ပေါင်းစပ်စမ်းသပ်မှုများ (integration tests) သည် ပိုက်ဆံကုန်ကျခြင်း သို့မဟုတ် ဆာဗာများ တည်ဆောက်ရန် မလိုဘဲ API ကို အကန့်အသတ်မရှိ စမ်းသပ်အသုံးပြုနိုင်ပါသည်။

လူသားများအတွက် OIDC

အသုံးပြုသူ စက်ရှင်များသည် Keycloak-issued JWT များဖြင့် အတည်ပြုခြင်းခံရပြီး realm ၏ အများဆိုင်သော သော့ချက် (public key) နှင့် တိုက်ဆိုင်စစ်ဆေးကာ API သော့ချက်တစ်ခု လုပ်ဆောင်သကဲ့သို့ တူညီသော Principal အရာဝတ္ထုအဖြစ်သို့ ပြောင်းလဲပေးပါသည်။ အဆုံးမှတ် (endpoints) များသည် အဖွဲ့အစည်းတစ်ခုချင်းအလိုက် စစ်ဆေးသည့် sites.create သို့မဟုတ် apikeys.manage ကဲ့သို့သော အသေးစိတ်ခွင့်ပြုချက်သော့ချက်များကို ကန့်သတ်ထားရှိပြီး - အဖွဲ့အစည်းတစ်ခုတွင်ရှိသော ခွင့်ပြုချက်သည် သီးခြားလွတ်လပ်ပြီး မသက်ဆိုင်သော အဖွဲ့အစည်းတစ်ခုတွင် မည်သည့်ဝင်ရောက်ခွင့်မျှ ပေးမည်မဟုတ်သော်လည်း ၎င်း၏အောက်တွင် အထပ်ဆင့်ပါရှိသော အဖွဲ့အစည်းများအပေါ်တွင်မူ အကျုံးဝင်ပါသည်။

အောက်ခံ အတန်းအဆင့် လုံခြုံရေး

tenant တောင်းဆိုမှုတိုင်းကို principal မှ သတ်မှတ်ထားသော Postgres org scope ဖြင့် transaction တစ်ခုအတွင်း လုပ်ဆောင်ပေးသောကြောင့် ORM filter ကို တစ်စုံတစ်ဦးက မေ့သွားနိုင်သည့် အခြေအနေမျိုးတွင်ပင် ဒေတာဘေ့စ်ကိုယ်တိုင်က isolation ကို တင်းတင်းကျပ်ကျပ် လုပ်ဆောင်ပေးပါသည်။ queryset filter သည်လည်း အလွှာစုံ လုံခြုံရေး (defence in depth) အနေဖြင့် ဆက်လက်ရှိနေပါသည်။

သစ်စက်များအတွက်သာမဟုတ်၊ သရုပ်ပြမှုများအတွက်သာမဟုတ်ဘဲ တည်ဆောက်ထားသည်

API တစ်ခုကို README တွင် ကြည့်ကောင်းအောင် ပြုလုပ်ရန် လွယ်ကူသော်လည်း လက်တွေ့ အသွားအလာအောက်တွင် ကောင်းမွန်စွာ လည်ပတ်စေရန်မှာ ခက်ခဲပါသည်။ ဤအရာများသည် ကျွန်ုပ်တို့ အထူးအာရုံစိုက်ခဲ့ရသည့် အပိုင်းများဖြစ်သည်၊ အကြောင်းမှာ ၎င်းတို့သည် မနက်သုံးနာရီတွင် ပေါင်းစပ်မှုများကို ပျက်ယွင်းစေတတ်သော အပိုင်းများ ဖြစ်သောကြောင့်တည်း။

မီးမောင်းထိုးပြလိုသည့် အသေးစိတ်အချက်တစ်ခုမှာ အစုလိုက်လုပ်ဆောင်မှုပုံစံကို လွှမ်းမိုးထားသောကြောင့်ဖြစ်သည် - ထပ်နေသော ဒိုမိန်းပေါ်ရှိ 409 တုံ့ပြန်မှုသည် မည်သည့် tenant အတွက်မဆို "ဤ hostname ကို ဤနေရာတွင် ဟို့စ်လုပ်ထားသလား" ဟူသည်ကို ဖြေကြားပေးပြီး၊ ယင်းသည် ထုတ်ဖော်ပြသနိုင်သော အခွင့်အလမ်းတစ်ခုဖြစ်သည့်အပြင် Footprint-Free ကို မည်သူမည်ဝါဖြစ်ကြောင်း ပေါ်ပေါက်စေနိုင်သည့် အမှန်တကယ် စိန်ခေါ်မှုတစ်ခုလည်း ဖြစ်သည်။ ဝဘ်ဆိုက်ဖန်တီးမှုကို ကန့်သတ်လိုက်ခြင်းသည် လွယ်ကူသော ဖြေရှင်းနည်းဖြစ်နိုင်သော်လည်း အစုလိုက် ဝန်ဆောင်မှုပေးသည့် ထုတ်ကုန်ကို လုံးဝ ပျက်စီးသွားစေမည်ဖြစ်သည်။ ထို့အစား ပယ်ချခံရသည့် ထပ်နေသော ဒိုမိန်း ကြိုးပမ်းမှုများကိုသာ သုံးစွဲသူအလိုက် ကန့်သတ်ချက် သတ်မှတ်ထားသည်။ အောင်မြင်သော ဖန်တီးမှုများအတွက် မည်သည့်အခါမျှ အကန့်အသတ်မရှိပါ - ထို့ကြောင့် သင်သည် တစ်နေကုန် အစုလိုက် ဝန်ဆောင်မှုပေးနိုင်ပြီး ချောင်းမြောင်းစုံစမ်းမှုများသည် ချက်ချင်းနီးပါး ရပ်တန့်သွားမည်ဖြစ်သည်။

  • ချို့ယွင်းမှုတိုင်းတွင် တသမတ်တည်းရှိသော အမှားအယွင်းစာအိတ်တစ်ခု ပါရှိသည်- ကုဒ်တစ်ခု၊ လူဖတ်နိုင်သော မက်ဆေ့ချ်တစ်ခု၊ ရွေးချယ်နိုင်သော အကွက်အဆင့်အသေးစိတ်အချက်အလက်များနှင့် ပံ့ပိုးကူညီမှုတွင် သင်ကိုးကားနိုင်သော request_id တစ်ခုတို့ ဖြစ်သည်။ အတည်ပြုခြင်းဆိုင်ရာ အမှားအယွင်းများသည် အပြစ်ရှိသောအကွက်များကို အမည်ပေးလျက် 422 ကို ပြန်ပေးသည်။
  • POST တွင် အိုင်ဒီပိုတန်စီ (Idempotency) သော့ချက်များ ပါရှိပြီး၊ ရလဒ်ကို အထဲတွင်ထည့်သွင်းရေးသားခြင်းထက် အတည်ပြုချက် (commit) ပြုလုပ်ချိန်တွင် ပြန်လည်ပြသသည့်မှတ်တမ်းကို ရေးသားပေးသောကြောင့် ပြန်လည်ကြိုးပမ်းမှုတစ်ခုသည် အတည်မပြုခဲ့ရသည့် စာကြောင်းတစ်ကြောင်းကို အမည်ပေးထားသည့် ကက်ရှ်လုပ်ထားသော 201 ကို မည်သည့်အခါမျှ ပြန်လည်ပြသနိုင်မည် မဟုတ်ပါ။ မအောင်မြင်သော တောင်းဆိုမှုတစ်ခုသည် ၎င်း၏ လုပ်ဆောင်ဆဲ သော့ခတ်မှုကို ချက်ချင်းလွှတ်ပေးသောကြောင့် 422 သည် သင်၏ ပြင်ဆင်ထားသော ပြန်လည်ကြိုးပမ်းမှုကို သော့ခတ်မသွားစေပါ။
  • UUIDv7 ကျော်လွန်သော သော့စာရင်းအနေဖြင့် ကာဆာစာမျက်နှာခွဲခြင်း — တပြိုင်နက်တည်း ရေးသားမှုများအောက်တွင် တည်ငြိမ်ပြီး၊ စာကြောင်းများ ကြားဖြတ်ထည့်သွင်းသည့်အခါ စာမျက်နှာလွဲမှားခြင်း မရှိပါ။
  • တုံ့ပြန်မှုများတွင် RateLimit-Remaining ပါရှိသောကြောင့်၊ ဖန်တီးထားသော client တစ်ခုသည် မန်းဆန်းလုပ်မည့်အစား အသိဉာဏ်ရှိရှိဖြင့် ဆုတ်ခွာနိုင်မည်ဖြစ်သည်။
  • နယ်ပယ်ပြင်ပရှိ အရင်းအမြ်များသည် 403 အစား 404 ကို ပြန်ပေးသည် — 403 သည် အရင်းအမြစ် ရှိနေကြောင်း အတည်ပြုပေးသကဲ့သို့ ဖြစ်နေမည်။ သင့်နယ်ပယ်ပြင်ပရှိ အဖွဲ့အစည်းဖြင့် စစ်ထုတ်ခြင်းသည်လည်း အလားတူအကြောင်းပြချက်ကြောင့် အလွတ်စာမျက်နှာကို ပြန်ပေးသည်။
  • ဆိုက်ဖန်တီးခြင်းဆိုသည်မှာ ပရိုဗစ်ရှင်တင်ခြင်းမဟုတ်ဘဲ မှတ်ပုံတင်ခြင်းဖြစ်သည်- POST /v1/sites သည် အခြေအနေ pending ဖြင့် 201 ကို ပြန်ပေးပြီး တည်ဆောက်မှုအပေါ် ဘယ်သောအခါမှ မပိတ်ဆို့ပါ။ ဖြစ်ရပ်ကို အတန်းပါရှိသော ငွေကြေးလွှဲပြောင်းမှုကဲ့သို့သော ငွေကြေးလွှဲပြောင်းမှု outbox တွင် တူညီစွာ ရေးသားထားသောကြောင့် ၎င်း၏ပရိုဗစ်ရှင်တင်ခြင်းကို တောင်းဆိုရန် အာမခံထားမှသာ ဆိုက်တစ်ခု တည်ရှိမည်ဖြစ်သည်။

SDKs၊ CLI တစ်ခုနှင့် Terraform provider တစ်ခု

လုပ်ငန်းခွင်သုံးပုံစံ အမျိုးအစား ကွဲပြားမှုအတွက် တူညီသော သတ်မှတ်ချက်ပါရှိသည့် သုံးစွဲသူ သုံးဦး။

ဝယ်ယူသူသုံး SDK များ

TypeScript၊ Python၊ PHP နှင့် Go တို့အတွက် ထုတ်လုပ်ထားပြီး လက်ဖြင့်ရေးသားထားသော ရပ်ပါအား စောင့်ဆိုင်းနေစရာမလိုဘဲ သင့်ဘာသာစကားဖြင့် အမှတ်အသားအသစ်တစ်ခု ရောက်ရှိလာစေရန် သတ်မှတ်ချက်ကို ခြေရာခံထားသည်။

Zinnector®၊ CLI

WordPress ဖြင့် ဆိုက်တစ်ခုကို တည်ဆောက်ပါ၊ Node မှလွဲ၍ မည်သည့်အရာမျှ ထည့်သွင်းထားခြင်း မရှိဘဲ ၎င်းကို ဒေသတွင်း၌ လည်ပတ်စေကာ ဖြန့်ကျက်လုပ်ဆောင်ပါ။ Zinnector® သည် သင်ဖြန့်ကျက်တော့မည့် ဆလော့နှင့် ဆန့်ကျင်ဘက်ဖြစ်သော သင့်ပရောဂျက်ကို (PHP ဗားရှင်း၊ ဒစ်ခ်၊ ဖိုင်အရေအတွက်) ကြိုတင်စစ်ဆေးပေးပြီး၊ ပို့စ်တင်ပြီးမှထက် မတင်မီတွင် ကြိုတင်သတိပေးပါသည်။ ၎င်းသည် အကောင့်ဝင်ခြင်း၊ ဆိုက်များကို စာရင်းပြုစုခြင်း၊ ဖြန့်ကျက်ခြင်း၊ ဒိုမိန်းများနှင့် DNS ကို စီမံခန့်ခွဲခြင်း၊ မေးလ်ဝန်ဆောင်မှုများကို ဖတ်ရှုခြင်း၊ အရန်သိမ်းဆည်းမှုများ ပြုလုပ်ခြင်း၊ ခွင့်ပြုချက်စာရင်းသွင်းထားသော WP-CLI ကို လုပ်ဆောင်ခြင်း၊ လော့ဂ်များကို ကြည့်ရှုခြင်းနှင့် အစုလိုက်လုပ်ဆောင်ချက်များကို လုပ်ဆောင်ခြင်းတို့ လုပ်ဆောင်ပေးပါသည်။ အခမဲ့ဖြစ်ပြီး MIT လိုင်စင်ရရှိထားကာ ဤတူညီသော လူသိရှင်ကြားရရှိနိုင်သည့် API ပေါ်တွင် တည်ဆောက်ထားပါသည်။

Terraform ပlatform

ဆိုဒ်များ၊ ဒိုမိန်းများ၊ DNS မှတ်တမ်းများ၊ မေးလ်ဘောက်စ်များနှင့် ပလန်များကို အခြေခံအဆောက်အအုံအဖြစ် ကုဒ်ဖြင့် စီမံခန့်ခွဲပါ။ terraform apply သည် ဟို့စ်တင်းကို စီစဉ်ပေးပြီး သင်၏ပတ်ဝန်းကျင်များသည် မည်သူမျှချရေးမထားသည့် ကလစ်နှိပ်မှု အစဉ်လိုက်များအစား ပြန်လည်ထုတ်လုပ်နိုင်ပြီး ပြန်လည်သုံးသပ်နိုင်သော အရာများ ဖြစ်လာစေသည်။

တုံ့ပြန်လုပ်ဆောင်နိုင်သော ကိုးကားချက်

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

သင့်အမှားခံအချက်အလက် (endpoint) ပိတ်သွားသည့်တိုင်အောင် အလုပ်လုပ်နေမည့် ဝဘ်ဟွတ်များ (Webhooks)

ပလက်ဖောင်း၏ နောက်ကွယ်တွင် ခိုင်မာသော အစီအစဉ် ရေးဆွဲမှု ပင်မစနစ် ရှိသည်- အခြေအနေ ပြောင်းလဲမှု တိုင်းသည် ဒေတာဘေ့စ် ပြောင်းလဲမှုနှင့်အတူ တစ်ပြိုင်နက်တည်း Postgres ရှိ transactional outbox သို့ အစီအစဉ်တစ်ခုအဖြစ် ရေးသားပြီး၊ relay တစ်ခုက ၎င်းကို NATS JetStream သို့ ထုတ်ဝေပေးသည်။ အစီအစဉ်များကို အမျိုးအစား ခွဲခြားထားပြီး ဗားရှင်း သတ်မှတ်ထားသည် — site.deployed၊ order.paid၊ invoice.overdue၊ backup.completed၊ abuse.flagged၊ trial.ending နှင့် အခြားအရာများ ဖြစ်ကြသည်။

သင်စိတ်ဝင်စားတာတွေကို စာရင်းသွင်းပါ

WebhookSubscription တစ်ခုအနေဖြင့် endpoint တစ်ခုကို မှတ်ပုံတင်ပြီး ၎င်းလက်ခံရရှိမည့် ပွဲစားမျိုးစားများကို ရွေးချယ်ပါ။ စီးကြောင်းတစ်ခုတည်းဖြင့် အသိပေးချက်များ၊ ခွဲခြမ်းစိတ်ဖြာမှုများ၊ အလိုအလျောက်လုပ်ဆောင်မှုများနှင့် သင်၏ပေါင်းစပ်မှုကိုပါ အတူတူကျွေးမွေးပေးပါသည် — သင်သည် ကျွန်ုပ်တို့နှင့် တူညီသောပွဲများကိုပင် သုံးစွဲနေခြင်း ဖြစ်ပါသည်။

HMAC ဖြင့် လက်မှတ်ထိုးထားသည်

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

နောက်ဆုတ်မှုဖြင့် ပြန်လည်ကြိုးစားခဲ့ပြီး မှတ်တမ်းတင်ထားသည်

မအောင်မြင်သော ပေးပို့မှုများကို ဖြည်းဖြည်းချင်း အကြိမ်ကြိမ် ပြန်လည်ကြိုးစားမည်ဖြစ်ပြီး ကြိုးပမ်းမှုတစ်ခုစီကို WebhookDelivery အဖြစ် မှတ်တမ်းတင်ထားသည်။ ကျွန်ုပ်တို့ ဘာပေးပို့ခဲ့သလဲဟု အကူအညီတောင်းခံရေးအီးမေးလ် ပေးပို့မည့်အစား ဒက်ရှ်ဘုတ်မှ ပေးပို့မှုများကို စစ်ဆေးခြင်းနှင့် ပြန်လည်ဖွင့်ကြည့်ခြင်းတို့ ပြုလုပ်နိုင်သည်။

အနည်းဆုံးတစ်ကြိမ်ဖြစ်သောကြောင့် id ဖြင့် ထပ်နေသည်များကို ဖယ်ရှားပါ

pipeline သည် အတိအကျတစ်ကြိမ်မျှသာ လုပ်ဆောင်သည်ဟု ဟန်ဆောင်နေခြင်းထက် နှောင့်နှေးကြန့်ကြာမှုမရှိဘဲ အနည်းဆုံးတစ်ကြိမ် လုပ်ဆောင်နိုင်ရန် ရည်ရွယ်တည်ဆောက်ထားခြင်း ဖြစ်ပါသည်။ ထုတ်ဝေနေစဉ်အတွင်း ရပ်တန့်သွားသော relay တစ်ခုသည် ၎င်း၏ claim lease သက်တမ်းကုန်ဆုံးသွားမည်ဖြစ်ပြီး ၎င်း၏ အဖြစ်အပျက်များကို ထပ်မံထုတ်ဝေမည် ဖြစ်သည်။ envelope id တွင် dedupe လုပ်ပါ၊ သို့မှသာ သင်၏ consumer သည် တည်ဆောက်မှုအရ မှန်ကန်နေမည် ဖြစ်သည်။

ဝဘ်ဆိုက်ပေါ်သို့ ကုဒ်ထည့်သွင်းခြင်း

API ဆိုတာ ဆော့ဖ်ဝဲရေးသားသူတစ်ဦးရဲ့ ခရီးလမ်းရဲ့ တစ်ဝက်သာရှိပါတယ်။ ကျန်တစ်ဝက်ကတော့ ထုတ်လုပ်တင်ပို့ခြင်းပါပဲ။

  • Deploy keys များကို config ဖိုင်ထဲတွင် မဟုတ်ဘဲ credential store ထဲ၌ ထိန်းသိမ်းထားပြီး GitHub၊ GitLab သို့မဟုတ် Bitbucket ကို OAuth မှတစ်ဆင့် ချိတ်ဆက်ပါ။
  • Push က composer နဲ့ npm အတွက် stack တစ်ခုချင်းစီအလိုက် တည်ဆောက်မှုအဆင့်များ၊ ဘရန့်မှ-ပတ်ဝန်းကျင်သို့ ချိတ်ဆက်မှု (main ကို production သို့၊ staging ကို staging သို့) တို့ပါဝင်သည့် တည်ဆောက်ပြီး-ဖြန့်ဝေသည့် ပိုက်လိုင်း (build-and-deploy pipeline) တစ်ခုကို စတင်လုပ်ဆောင်ပေးပါသည်။
  • ဖြန့်ချိမှု အဆင်မပြေသည့်အခါ ယခင်ထွက်ရှိခဲ့သော ဗားရှင်းသို့ ပြန်သွားပါ။
  • ဧည့်သည်များထံသို့ မရောက်ရှိမီ အမှန်တကယ်နေရာတစ်ခုတွင် အပြောင်းအလဲတစ်ခုကို စမ်းသပ်အတည်ပြုနိုင်ရန် စတေ့ဂျင်း ကလုန်းနှင့် ပွတ်ရှ်-တု-လစ်ဗ် (Staging clone and push-to-live) ပြုလုပ်ခြင်း။
  • CageFS ၏ သီးသန့်ခွဲထုတ်မှုအောက်တွင် ဆိုက်တစ်ခုချင်းစီအတွက် Jailed SSH၊ SFTP နှင့် FTP တို့ကို အသုံးပြုနိုင်သဖြင့် သုံးစွဲသူတစ်ဦးချင်းစီသည် ၎င်းတို့၏ကိုယ်ပိုင်ဖိုင်များကိုသာ မြင်တွေ့ရမည်ဖြစ်သည်။
  • panel terminal နှင့် SSH ထက်မှ wp-cli။
  • code-server မှတစ်ဆင့် ဘရောက်ဆာထဲတွင် သုံးနိုင်သော VS Code — တိုးချဲ့ဆော့ဖ်ဝဲများ၊ ပါဝင်ပြီးသား terminal နှင့် git တို့ဖြင့် စိုက်ထုတ်ပြင်ဆင်နိုင်သော ပြည့်စုံသည့် တည်းဖြတ်ကိရိယာဖြစ်ပြီး ဝဘ်ဆိုက်၏ ဖိုင်များကို တိုက်ရိုက် ပြင်ဆင်ပေးနိုင်ပါသည်။
  • ဆိုဒ်တစ်ခုစီအလိုက် PHP ဗားရှင်း၊ ပြင်ဆင်နိုင်သော PHP ဆက်တင်များ၊ ဆိုဒ်တစ်ခုစီအလိုက် တိုးချဲ့ချက်များ၊ ပတ်ဝန်းကျင် ဗာရီယေဘယ်လ်များနှင့် WP-cron အပြင် ပုံမှန် cron တို့ ပါဝင်သည်။

သင့် AI အေးဂျင့် အသုံးပြုနိုင်သည့် တူညီသော API လည်း ပါရှိသည်

ပလက်ဖောင်းကို ဟို့စ်တင်လုပ်ထားသော MCP ဆာဗာတစ်ခုအဖြစ် ကျွန်ုပ်တို့ ဖော်ပြပေးထားပါသည်- ၎င်းသည် အင်ဂျင် API ပေါ်ရှိ ပါးလွှာသော ပရိုတိုကော အဒပ်တာတစ်ခုဖြစ်ပြီး တူညီသော အက်ရှင် ကတ်တလောက်၊ RBAC နှင့် စာရင်းစစ်မှတ်တမ်းတို့ကို ပြန်လည်အသုံးပြုပါသည်။ Claude Code၊ Cursor၊ ChatGPT၊ Claude Desktop သို့မဟုတ် MCP ကို ​​အသုံးပြုနိုင်သည့် မည်သည့်ကလိုင်းယင့်ကိုမဆို တစ်ကြိမ်ချိတ်ဆက်လိုက်ရုံဖြင့် API တွင် ကျွန်ုပ်တို့ထည့်သွင်းသမျှ စွမ်းဆောင်ချက်တိုင်းသည် ၎င်းအတွက် အလိုအလျောက် ရရှိနိုင်မည်ဖြစ်သည်။

အေးဂျင့်က အရာသုံးခုကို ရရှိသည်- ကိရိယာများ (တိမ်းစောင်းသွားရန် အပြိုင်ယှဉ်တွဲသုံးသော ကျိုးကြောင်းဆင်ခြင်မှု မရှိသည့် တူညီသော API အမှတ်များ)၊ အရင်းအမြစ်များ (လုပ်ဆောင်ချက်မလုပ်ဆောင်မီ တကယ့်အချက်အလက်များဖြင့် ရောဂါရှာဖွေနိုင်စေရန်အတွက် ဖတ်ရှုရုံသက်သက်ဖြစ်သော ဆိုက်ကျန်းမာရေး၊ ဖွဲ့စည်းပုံ၊ မကြာသေးမီက မှတ်တမ်းများ၊ တိုင်းတာချက်များ၊ အလုပ်လုပ်ချိန်နှင့် KB ဆောင်းပါးများ) နှင့် အချက်ပြမှုများ ("ဤဆိုက်ကို ရောဂါရှာဖွေပါ" သို့မဟုတ် "ရွှေ့ပြောင်းရန် ပြင်ဆင်ပါ" ကဲ့သို့သော ထုတ်ဝေထားသော လုပ်ငန်းအသွားအလာ ပုံစံများ)။

ဘေးကင်းလုံခြုံရေးသည် အထောက်အထားစိစစ်ခြင်းလုပ်ငန်းစဉ်အတိုင်းပင် ဖြစ်ပါသည်- OAuth 2.1၊ သင့်အဖွဲ့အစည်းနှင့် ချိတ်ဆက်ထားသော တိုကင်များ၊ တန်းအဆင့် လုံခြုံရေးဖြင့် အသက်သွင်းထားသော RBAC ခွင့်ပြုချက်များ၊ တူးလ်တစ်ခုချင်းစီအလိုက် နယ်ပယ်သတ်မှတ်နိုင်ပြီး ပြန်လည်ရုပ်သိမ်းနိုင်မှု၊ ထုတ်လုပ်မှုပတ်ဝန်းကျင်မှ သီးခြားခွဲထုတ်ထားသော စမ်းသပ်ပတ်ဝန်းကျင် (sandbox) တို့ ပါဝင်ပါသည်။ ပျက်စီးဆုံးရှုံးမှုရှိနိုင်သော အရေးယူဆောင်ရွက်ချက်များ — ဖျက်ဆီးခြင်း၊ ဆိုင်းငံ့ခြင်း၊ ငွေတောင်းခံခြင်း၊ သုံးစွဲမှုပမာဏများပြားခြင်း — တို့အတွက် အတိအလင်း အတည်ပြုချက် သို့မဟုတ် လူကိုယ်တိုင် အတည်ပြုပေးရသည့် မူဝါဒ လိုအပ်ပါသည်။ အသုံးပြုမှုနှုန်း ကန့်သတ်ချက်များနှင့် သုံးစွဲမှု အထက်ကန့်သတ်ချက်များက AI ဖြင့် အလိုအလျောက် လုပ်ဆောင်သော ပေးချေရသည့် ဆောင်ရွက်ချက်များကို ထိန်းချုပ်ပေးထားပြီး MCP ခေါ်ဆိုမှုတိုင်း၏ အထောက်အထား၊ တူးလ်၊ အငြင်းပွားဖွယ် အချက်အလက်များနှင့် ရလဒ်တို့ကို အစစ်ဆေးခံ စာရင်းဇယားတွင် မှတ်တမ်းတင်ထားပါသည်။

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

မကြာခဏ မေးလေ့ရှိသော မေးခွန်းများ

public API သည် ဒက်ရှ်ဘုတ်အသုံးပြုနေသည့် API နှင့် တူပါသလား။

ဟုတ်ပါသည် — ၎င်းသည် ထုတ်ဝေထားပြီး ပိုမိုခိုင်မာအောင် ပြုလုပ်ထားသည့် တူညီသော engine API ပင် ဖြစ်ပါသည်။ Dashboard၊ admin console၊ CLI၊ Terraform provider၊ MCP server နှင့် webhooks တို့သည် တူညီသော မျက်နှာပြင်တစ်ခုတည်းကို သုံးစွဲထားခြင်း ဖြစ်သောကြောင့် API သည် panel ထက် နောက်ကျကျန်နေခြင်း မရှိရခြင်းဖြစ်ပါသည်။

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

ဟုတ်ကဲ့။ ဆဲလ်ဘောက်စ် သော့များကို ပရိုဒက်ရှင် သော့များနှင့် သီးခြားစီ ထုတ်ပေးပြီး စမ်းသပ်မုဒ်တွင် လုပ်ဆောင်ပါသည်- အမှန်တကယ် ငွေပေးချေခြင်းနှင့် အမှန်တကယ် ပံ့ပိုးပေးခြင်း မရှိပါ။ သင့် CI ကို ဆဲလ်ဘောက်စ် အထောက်အထားများဆီသို့ ညွှန်ပြပြီး တောင်းဆိုမှုနှင့် တုံ့ပြန်မှု စက်ဝန်းတစ်ခုလုံးကို ဘေးကင်းစွာ စမ်းသပ်ပါ။

ထပ်ခါထပ်ခါ လုပ်ဆောင်မှု (retry) ကြောင့် အရာတစ်ခု နှစ်ခု ပေါ်လာခြင်းကို ဘယ်လို တားဆီးရမလဲ။

သင်၏ POST တွင် Idempotency-Key တစ်ခု ပေးပို့ပါ။ ပြန်လည်လုပ်ဆောင်သည့် မှတ်တမ်းကို အင်လိုင်း (inline) အစား ကွန်မစ် (commit) လုပ်သည့်အခါတွင် ရေးသားခြင်းဖြစ်ရာ တကယ်တမ်း ကွန်မစ်မလုပ်ခဲ့သော စာကြောင်းတစ်ကြောင်းအတွက် ကက်ရှ်လုပ်ထားသော အောင်မြင်မှုကို ထပ်ခါတလဲလဲ ပြန်လည်မလုပ်ဆောင်နိုင်စေရန်နှင့် မအောင်မြင်သော တောင်းဆိုမှုတစ်ခုသည် ၎င်း၏လော့ခ်ကို ချက်ချင်းလွှတ်ပေးသောကြောင့် ပြင်ဆင်ထားသည့် သင်၏ထပ်ခါတလဲလဲ လုပ်ဆောင်မှုကို ကြန့်ကြာမနေစေရန် သေချာစေပါသည်။ ဝဘ်ဟွတ်ခ် (Webhook) ပေးပို့ခြင်းသည် ဒီဇိုင်းအရ အနည်းဆုံးတစ်ကြိမ်ဖြစ်ပါသည် - သင့်ဘက်ရှိ အိတ်ဗယ်လော့ (envelope) အိုင်ဒီတွင် ဒူပူ (dedupe) လုပ်ပါ။

ကျွန်ုပ်၏ ကlient အဖွဲ့အစည်းအားလုံးကို API သော့ တစ်ခုတည်းဖြင့် အသုံးပြုခွင့် ပေးနိုင်ပါသလား။

ယနေ့မဟုတ်ပါ။ API သော့များကို အဖွဲ့အစည်းတစ်ခုချင်းစီအတွက် ထုတ်ပေးထားသောကြောင့် အဖွဲ့အစည်းအများအပြားကို လွှမ်းခြုံထားသော ပေါင်းစပ်မှုတစ်ခုတွင် အဖွဲ့အစည်းတစ်ခုစီအတွက် သော့တစ်ခုစီ ရှိနေပါသည်။ အသုံးပြုသူ ပင်မများအတွက်လည်း အဖွဲ့အစည်းအလိုက် ခွင့်ပြုချက်များကို စစ်ဆေးပါသည်- အဖွဲ့အစည်းတစ်ခုတွင် sites.create ကို ကိုင်ဆောင်ထားခြင်းက သီးခြားနှင့် မဆိုင်သော အခြားအဖွဲ့အစည်းတစ်ခုတွင် မည်သည့်ဝင်ရောက်ခွင့်ကိုမျှ မပေးပါ၊ သို့သော် ၎င်းအောက်တွင် ရှိသော အဖွဲ့အစည်းခွဲများအတွက်မူ အကျုံးဝင်ပါသည်။ ၎င်းမှာ ရည်ရွယ်ချက်ရှိရှိ လုပ်ဆောင်ထားခြင်းဖြစ်ပြီး - ပျက်စီးသွားသော သော့တစ်ခု၏ အသုံးပြုမှုကို ပလက်ဖောင်းတစ်ခုလုံးသို့ မဟုတ်ဘဲ ၎င်း၏ကိုယ်ပိုင်အဖွဲ့အစည်းနှင့် ၎င်းအောက်ရှိ အဖွဲ့အစည်းခွဲများဆီသို့သာ ကန့်သတ်ထားခြင်း ဖြစ်ပါသည်။

ပါရှိပြီးသား Developer ဇာတ်ကောင် (role) က အမှန်တကယ် ဘာတွေ လုပ်ခွင့်ပေးပါသလဲ။

developer အခန်းကဏ္ဍတွင် အဖွဲ့အစည်းဆိုင်ရာ ဖတ်ရှုခြင်း၊ API သော့ စီမံခန့်ခွဲခြင်း၊ ဆိုက်များကို ကြည့်ရှုခြင်းနှင့် ဖန်တီးခြင်း၊ ၎င်းတို့ကို ပြန်လည်စတင်ခြင်း၊ ၎င်းတို့၏ ကက်ရှ်ကို ရှင်းလင်းခြင်းနှင့် လက်မှတ်များကို ကြည့်ရှုခြင်းနှင့် ပြန်ကြားခြင်းတို့ ပါဝင်သည်။ ၎င်းတွင် ငွေတောင်းခံလွှာ ထိန်းချုပ်မှုကို ရည်ရွယ်ချက်ရှိရှိ ဖယ်ထုတ်ထားသည်။ deploy နှင့် push-to-live ခွင့်ပြုချက်များသည် ၎င်း၏ အစိတ်အပိုင်းမဟုတ်ကြောင်း သတိပြုပါ - အဖွဲ့ဝင်တစ်ဦးသည် ၎င်းတို့ လိုအပ်ပါက Developer သည် အကျယ်ပြန့်ဆုံး နည်းပညာဆိုင်ရာ အခန်းကဏ္ဍဖြစ်သည်ဟု ယူဆမည့်အစား ၎င်းတို့ကို သယ်ဆောင်ပေးသည့် အခန်းကဏ္ဍတစ်ခုကို သတ်မှတ်ပေးပါ။

ကျွန်ုပ်၏ endpoint သည် တစ်နာရီခန့် ပျက်သွားပါက ကျွန်ုပ်၏ webhooks များအတွက် မည်သို့ဖြစ်မည်နည်း။

ပေးပို့မှုများကို နောက်ဆုတ်မှု (backoff) ဖြင့် ထပ်မံကြိုးစားမည်ဖြစ်ပြီး ကြိုးစားမှုတိုင်းကို သင်စစ်ဆေးနိုင်သည့် WebhookDelivery အဖြစ် မှတ်တမ်းတင်ထားသည်။ အပြောင်းအလဲနှင့်အတူ ဒေတာဘေ့စ်ငွေပေးငွေယူတစ်ခုတည်းတွင် အဆင့်မြင့်ဖြစ်ရပ်များကို ငွေပေးငွေယူအောက်စဘောက်စ်တစ်ခုသို့ ရေးသားထားသောကြောင့် သုံးစွဲသူမရနိုင်သည့်အခါ မည်သည့်အရာမျှ ပျောက်ဆုံးမသွားပါ - ပိတ်ထားသော သုံးစွဲသူသည် နောက်ကျကျန်နေမည်ဖြစ်ပြီး ထုတ်လုပ်သူအား ဘယ်သောအခါမှ မပျက်စီးစေဘဲ သင်ပြန်ရောက်သည်နှင့် ဒက်ရှ်ဘုတ်မှ ပေးပို့မှုများကို ပြန်လည်လုပ်ဆောင်နိုင်သည်။

၎င်းကို စတင်တည်ဆောက်ရန်အတွက် မည်မျှကုန်ကျမည်နည်း။

ငွေပေးချေမှုအချက်အလက် မလိုအပ်ဘဲ ဆိုက် 5 ခုအထိ ပါဝင်သော Footprint-Free Hosting ၏ 14 ရက် စမ်းသပ်ကာလကို ကတ်ပြားမလိုဘဲ စတင်လိုက်ပါ။ အခပေး Footprint-Free အဆင့်များကို PBN 5 အတွက် တစ်လလျှင် $6 ဖြင့် စတင်ပါသည်။ အစီအစဉ်တိုင်းတွင် 30 ရက် ငွေပြန်အမ်းပေးမည့်အာမခံချက်၊ အခမဲ့ ရွှေ့ပြောင်းမှုများနှင့် ရောင်းချသူတစ်ဦးတည်းအပေါ် မှီခိုနေရခြင်း မရှိမှုတို့ ပါဝင်ပါသည်။

သတ်မှတ်ချက်ကို ဖတ်ပါ၊ ထို့နောက် ၎င်းနှင့်အညီ တည်ဆောက်ပါ

စပတ်ဖ်-ဖတ်စထ် API၊ ဖန်တီးထားသော SDK များ၊ CLI တစ်ခု၊ Terraform ပံ့ပိုးပေးသူ၊ လက်မှတ်ထိုးထားသော ဝဘ်ဟွတ်များနှင့် MCP ဆာဗာတစ်ခု — တစ်ကမ္ဘာလုံးရှိ ဝဘ်ဆိုက် ၆၅၀,၀၀၀ ကျော်အတွက် ကျွန်ုပ်တို့ တည်ဆောက်ထားသော ဟိုစတင်င်ပေါ်တွင်။ ငွေပေးချေမှု အချက်အလက်မလိုဘဲ အခမဲ့ ခရက်ဒစ်ကတ်မလိုသော ၁၄ ရက် စမ်းသပ်ကာလဖြင့် စတင်ပါ။

အခမဲ့ စတင်ပါ