သင့်ကိုယ်ပိုင်စနစ်များမှ Zinn® hosting ရောင်းချခြင်း

သင်သည် ကျွန်ုပ်တို့၏ ဟိုးစတင်းကို ပြန်လည်ရောင်းချနိုင်သည်။ သင့်ဖောက်သည်များသည် သင့်ဖောက်သည်များသာ ဖြစ်သည်- သင့်ဈေးနှုန်းများ၊ သင့်ပြေစာများ၊ သင့်ငွေပေးချေမှု ဝန်ဆောင်မှုပေးသူ။ ငွေတောင်းခံလွှာ ပန်နယ်တစ်ခု၊ သင်၏ကိုယ်ပိုင် WordPress ဆိုက် သို့မဟုတ် script တစ်ခုခုကဲ့သို့ သင်လက်ရှိအသုံးပြုနေသော မည်သည့်အရာမှမဆို ကျွန်ုပ်တို့၏ ပလက်ဖောင်းကို ဤနည်းအတိုင်း သင် မောင်းနှင်လည်ပတ်နိုင်သည်။

သင့်ဖောက်သည်များ အမှန်တကယ် မြင်တွေ့ရမည့်အရာ

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

⛔ မည်သည့်အရာကို ရွေးချယ်သည်ဖြစ်စေ သင်သည် သင့်ဖောက်သည်များအတွက် တာဝန်ခံ အရောင်းကိုယ်စားလှယ် (merchant of record) ဖြစ်သည်- သင့်ဈေးနှုန်းများ၊ သင့်ပြေစာများ၊ သင့် VAT နံပါတ်၊ သင့်ငွေပေးချေမှု ဝန်ဆောင်မှုပေးသူ။ ကျွန်ုပ်တို့သည် လက္ကားဈေးဖြင့် တစ်လလျှင်တစ်ကြိမ် သင့်ထံသို့ ငွေတောင်းခံလွှာ ပို့ပါမည်။

ပန်နယ် hostname တစ်ခုကို သတ်မှတ်ပြီးပါက ၎င်းကို WordPress ပလပ်အင်၏ Panel address အကွက်တွင်သာ ထည့်သွင်းပါ၊ အခြားမည်သည့်နေရာတွင်မျှ မထည့်ပါနှင့် — ဤ API မှ ထုတ်ပေးသော အကောင့်ဝင်လင့်ခ်များသည် ၎င်းနောက်သို့ အလိုအလျောက် လိုက်ပါသွားမည်ဖြစ်သည်။

ချိတ်ဆက်အသုံးပြုနိုင်သော နည်းလမ်းလေးသွယ်

ချိတ်ဆက်အသုံးပြုနိုင်သော နည်းလမ်းလေးသွယ်ရှိပြီး ၎င်းတို့အားလုံးသည် အတွင်းပိုင်းတွင် တူညီသောအလုပ်ကို လုပ်ဆောင်ကြသည်-

၁။ API key တစ်ခု ရယူပါ

သင့်ဒက်ရှ်ဘုတ်တွင် API keys သို့ သွားပြီး တစ်ခုဖန်တီးပါ။ လိုအပ်သောအရာများကိုသာ ခွင့်ပြုချက်ပေးပါ-

⛔ ချိတ်ဆက်မှုတစ်ခုသို့ reseller.manage ခွင့်ပြုချက် မပေးပါနှင့်။ ထိုခွင့်ပြုချက်သည် သင့်ဈေးနှုန်းစာရင်းနှင့် သင့်ကိုယ်ပိုင် payment-gateway အထောက်အထားများကို တည်းဖြတ်နိုင်စွမ်းရှိသည်။ ငွေတောင်းခံလွှာ ပန်နယ် သို့မဟုတ် ဝက်ဘ်ဆိုက်တစ်ခုထဲသို့ သင်ထည့်သွင်းမည့် key တွင် ၎င်းကို မလိုအပ်စေရန်အတွက် reseller.provision ကို အတိအကျ သီးသန့်ပြုလုပ်ထားခြင်း ဖြစ်သည်။

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

၂။ သင်၏ ပထမဆုံး ခေါ်ယူမှုကို ပြုလုပ်ပါ

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

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

၃။ ချိတ်ဆက်မှုတစ်ခုလုံး၊ ခေါ်ယူမှု ခြောက်ခုဖြင့်

အချိန်                 ခေါ်ယူမှု
အော်ဒါတစ်ခုအတွက် ငွေပေးချေပြီးချိန်     POST   /v1/orgs                                   CUSTOMER တစ်ဦးလျှင် တစ်ကြိမ်
                     POST   /v1/sites                                  SERVICE တစ်ခုလျှင် တစ်ကြိမ်
၎င်းတို့ ငွေမပေးချေရသေးချိန်   POST   /v1/reseller/services/{siteId}/suspend
၎င်းတို့ ငွေပေးချေချိန်             POST   /v1/reseller/services/{siteId}/unsuspend
၎င်းတို့ ပယ်ဖျက်ချိန်          DELETE /v1/sites/{siteId}
"ဟိုးစတင်းသို့ ဝင်ပါ"  POST   /v1/reseller/services/{siteId}/sso

ပြင်ဆင်ဖန်တီးခြင်းသည် ခေါ်ယူမှုနှစ်ခုဖြစ်ပြီး key များသည် အရေးပါသည်-

# 1. ဖောက်သည်၏ အကောင့် — သင့် CUSTOMER id အပေါ် အခြေခံသည်
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. ၎င်းတို့၏ ဆိုက် — သင့် SERVICE id အပေါ် အခြေခံသည်
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

သင်မှားယွင်းပါက ငွေကြေးဆုံးရှုံးစေမည့် စည်းမျဉ်းနှစ်ခု

၁။ အကောင့်ကို သင့် CUSTOMER ပေါ်တွင် အခြေခံပြီး ဆိုက်ကို သင့် SERVICE ပေါ်တွင် အခြေခံပါ။ ဖောက်သည်တစ်ဦး၏ ဒုတိယအော်ဒါသည် ၎င်းတို့တွင် ရှိပြီးသားဖြစ်သော အကောင့်ထဲသို့ ရောက်ရှိရမည်။ နှစ်ခုစလုံးကို ဝန်ဆောင်မှုအပေါ် အခြေခံလိုက်ပါက ဖောက်သည်တစ်ဦးတည်းသည် ဆက်စပ်မှုမရှိသော အကောင့်သုံးခုနှင့် သီးခြားပန်နယ်သုံးခု ဖြစ်သွားပေလိမ့်မည်။ ၂။ သက်ဆိုင်ရာအရာအတွက် သင့်ကိုယ်ပိုင် id မှ တည်ဆောက်ထားသော Idempotency-Key တစ်ခုကို POST တိုင်းတွင် ပေးပို့ပါ။ ငွေတောင်းခံလွှာ စနစ်တိုင်းသည် ထပ်မံကြိုးစားတတ်ကြသည် — gateway callback တစ်ခုသည် နှစ်ကြိမ်ရောက်ရှိလာခြင်း၊ စီမံခန့်ခွဲသူတစ်ဦးက မအောင်မြင်သော ပြင်ဆင်မှုကို ထပ်မံလုပ်ဆောင်ခြင်း၊ ဖောက်သည်တစ်ဦးက နှစ်ချက်နှိပ်မိခြင်းတို့ ဖြစ်တတ်သည်။ key မပါရှိပါက ဒုတိယအကြိမ် ကြိုးပမ်းမှုသည် ဒုတိယဆိုက်တစ်ခုကို ဖန်တီးပေးမည်ဖြစ်ပြီး ၎င်းအတွက် သင့်ထံ ငွေတောင်းခံလွှာ ရောက်လာပါလိမ့်မည်။

သင် နှစ်ခုအဖြစ် ပေါင်းမပစ်ရမည့် အဖြေသုံးခု

• unsuspend သည် 409 ကို အဖြေပေးနိုင်သည်။ ဆိုလိုသည်မှာ ကျွန်ုပ်တို့၏ abuse အဖွဲ့က ဆိုက်ကို ထိန်းသိမ်းထားခြင်းဖြစ်ပြီး သင်မဟုတ်ပါ။ မက်ဆေ့ဂျ်ကို ပြသပါ၊ ထပ်မံမကြိုးစားပါနှင့်။
• **ရပ်စဲခြင်းသည် ဖျက်ပစ်ရန် အချိန်သတ်မှတ်ခြင်း ဖြစ်ပြီး ချက်ချင်းဖျက်ပစ်ခြင်း မဟုတ်ပါ။** နေ့ရက်သည် pending_deletion_at အဖြစ် ပြန်လည်ရောက်ရှိလာမည်ဖြစ်သည်။ ဖောက်သည်တစ်ဦးအား ၎င်းတို့၏ ဒေတာများ မပျက်စီးသေးမီ ပျက်စီးသွားပြီဟု ပြောခြင်းသည် မည်သည့်အရာမျှ မပြောခြင်းထက် ပိုမိုဆိုးရွားသည်။
• disk_used_bytes သည် null ဖြစ်နိုင်ပြီး null သည် သုည မဟုတ်ပါ။ ဆိုလိုသည်မှာ ကျွန်ုပ်တို့ တိုင်းတာ၍မရခဲ့ခြင်းဖြစ်ပြီး မည်သည့်အရာမျှ အသုံးမပြုခဲ့ခြင်း မဟုတ်ပါ။ ၎င်းကို ကျော်သွားပါ — သင့်ကိုယ်ပိုင် မှတ်တမ်းများထဲသို့ 0 ဟု မရေးပါနှင့်၊ သို့မဟုတ်ပါက သင်သည် တိုင်းတာမှု မရရှိထားသော ဆိုက်တစ်ခုအတွက် ဖောက်သည်အား အစိမ်းရောင် အသုံးပြုမှုပြဘားကို ပြသမိပါလိမ့်မည်။

၄။ ဖောက်သည်တစ်ဦးကို အကောင့်ဝင်ရောက်စေခြင်း

POST /v1/reseller/services/{siteId}/sso သည် သင့်ဖောက်သည်အား ၎င်းတို့၏ ကိုယ်ပိုင်အကောင့်ထဲသို့ အကောင့်ဝင်ပြီးသားအနေအထားဖြင့် တိုက်ရိုက်ရောက်ရှိစေမည့် တစ်ကြိမ်သာသုံးနိုင်သော URL တစ်ခုကို ပြန်လည်ပေးပို့သည်။

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

၅။ ယင်းအစား မော်ဂျူးတစ်ခုကို ထည့်သွင်းပါ

• WHMCS — မော်ဂျူးကို modules/servers/zinn/ သို့ ကူးယူပါ၊ ၎င်း၏ Password သည် သင့် API key ဖြစ်သော ဆာဗာတစ်ခုကို ထည့်ပါ၊ ထုတ်ကုန်ပေါ်တွင် ထုတ်ကုန်လိုင်းကို သတ်မှတ်ပါ။ Test Connection ကို နှိပ်ပါ- ၎င်းသည် အမှန်တကယ် ခေါ်ယူမှုတစ်ခု ပြုလုပ်ပြီး ပလက်ဖောင်းမှ အကြောင်းပြန်ကြားချက်ကို သင့်အား ပြောပြပါလိမ့်မည်။
• HostBill — includes/modules/Hosting/zinn/ သို့ ကူးယူပြီး တူညီသောနည်းလမ်းအတိုင်း ချိတ်ဆက်ပါ။
• WordPress — Zinn® Reseller Toolkit- ဒိုမိန်းရှာဖွေမှု၊ သင့်ဖောက်သည်များ၏ ဟိုးစတင်းထဲသို့ အကောင့်ဝင်ရန် လင့်ခ်တစ်ခုနှင့် အော်ဒါတစ်ခုအတွက် ငွေပေးချေပြီးချိန်တွင် WooCommerce ဝန်ဆောင်မှု ဖြည့်ဆည်းပေးခြင်း။ အခမဲ့ ပွင့်လင်းရင်းမြစ်အဖြစ် <https://github.com/Zinn-Digital/zinn-reseller-toolkit> တွင် ရယူနိုင်သည်၊ သို့မဟုတ် သင့်ဒက်ရှ်ဘုတ်ရှိ Plugins မှ ၎င်းကို ဒေါင်းလုဒ်လုပ်ပါ။

၆။ စတင်အသုံးပြုခြင်း

အမှန်တကယ် အော်ဒါတစ်ခုကို မလက်ခံမီ ဤအရာများကို စစ်ဆေးပါ-

• မော်ဂျူးပေါ်တွင် ချိတ်ဆက်မှုစမ်းသပ်မှု အောင်မြင်သည် သို့မဟုတ် သင်၏ ပထမဆုံး curl သည် စာရင်းတစ်ခုကို ပြန်လည်ပေးပို့သည်။
• သင့်ဈေးနှုန်းစာရင်းကို သတ်မှတ်ထားသည် (Reselling → Your prices)။
• သင့် payment gateway ကို ချိတ်ဆက်ထားသည် (Reselling → Payment gateways) — သင့်ဖောက်သည်များသည် သင့်ကိုယ်ပိုင် အကောင့်မှတစ်ဆင့် သင့်ထံ ငွေပေးချေကြသည်။
• သင့်ကုမ္ပဏီ အသေးစိတ်အချက်အလက်များကို ထည့်သွင်းထားသည် (Reselling → Your company) ထို့ကြောင့် သင့်ဖောက်သည် ပြေစာများတွင် ကျွန်ုပ်တို့၏ အချက်အလက်များ မဟုတ်ဘဲ သင့်တရားဝင် အဖွဲ့အစည်းနှင့် VAT နံပါတ်တို့ ပါဝင်မည်ဖြစ်သည်။
• သင်သည် အစအဆုံး အမှန်တကယ် အော်ဒါတစ်ခုကို ပြုလုပ်ခဲ့ပြီး ဆိုက်ပေါ်လာသည်ကို စောင့်ကြည့်ခဲ့ပြီးဖြစ်သည်။

အခြားအရာအားလုံး ရှိသည့်နေရာ

အပြည့်အစုံဖြစ်သော API ကိုးကားချက် — ကျွန်ုပ်တို့၏ သတ်မှတ်ချက်များမှ ထုတ်ပေးထားပြီး တစ်ခုစီအတွက် လိုအပ်သော ခွင့်ပြုချက်များပါရှိသည့် endpoint တိုင်း — ကို <https://zinndigital.com/developers/api> တွင် ရရှိနိုင်သည်။