ຂາຍໂຮສຕິ້ງ Zinn® ຈາກລະບົບຂອງທ່ານເອງ

ທ່ານຂາຍຕໍ່ໂຮສຕິ້ງຂອງພວກເຮົາ. ລູກຄ້າຂອງທ່ານເປັນຂອງທ່ານເອງ: ລາຄາຂອງທ່ານ, ໃບແຈ້ງໜີ້ຂອງທ່ານ, ຜູ້ໃຫ້ບໍລິການຊຳລະເງິນຂອງທ່ານ. ນີ້ແມ່ນວິທີທີ່ທ່ານຄວບຄຸມແພລດຟອມຂອງພວກເຮົາຈາກສິ່ງໃດກໍຕາມທີ່ທ່ານນຳໃຊຢູແລ້ວ — ແຜງຄວບຄຸມການຮຽກເກັບເງິນ, ເວັບໄຊ WordPress ຂອງທ່ານເອງ, ຫຼື ສະຄຣິບ.

ສິ່ງທີ່ລູກຄ້າຂອງທ່ານເຫັນຕົວຈິງ

ກ່ອນທີ່ຈະເຂົ້າສູ່ຂັ້ນຕອນການເຮັດວຽກ: ລູກຄ້າຂອງທ່ານບໍ່ຈຳເປັນຕ້ອງເຫັນພວກເຮົາເລີຍ. ມີສາມຮູບແບບການໃຊ້ງານ, ແລະ ທ່ານສາມາດເລືອກຮູບແບບທີ່ທ່ານຕ້ອງການໃຊ້ໄດ້.

⛔ ບໍ່ວ່າທ່ານຈະເລືອກແບບໃດ, ທ່ານຄືຜູ້ຂາຍທີ່ມີຊື່ບັນທຶກທາງທຸລະກິດສຳລັບລູກຄ້າຂອງທ່ານ: ລາຄາຂອງທ່ານ, ໃບແຈ້ງໜີ້ຂອງທ່ານ, ເລກປະຈຳຕົວຜູ້ເສຍພາສີມູນຄ່າເພີ່ມຂອງທ່ານ, ຜູ້ໃຫ້ບໍລິການຊຳລະເງິນຂອງທ່ານ. ພວກເຮົາຈະຮຽກເກັບເງິນຈາກ ທ່ານ, ເດືອນລະຄັ້ງ, ໃນລາຄາຂາຍສົ່ງ.

ເມື່ອທ່ານຕັ້ງຄ່າຊື່ໂຮສຂອງແຜງຄວບຄຸມແລ້ວ, ໃຫ້ໃສ່ມັນລົງໃນຊ່ອງ Panel address ຂອງປລັກອິນ WordPress ແລະ ບໍ່ຕ້ອງໃສ່ໃນບ່ອນອື່ນອີກ — ລິ້ງເຂົ້າສູ່ລະບົບທີ່ API ນີ້ສ້າງຂຶ້ນຈະຕິດຕາມມັນໂດຍອັດຕະໂນມັດ.

ສີ່ຊ່ອງທາງໃນການເຂົ້າເຖິງ

ມີສີ່ຊ່ອງທາງໃນການເຂົ້າເຖິງ, ແລະ ທັງໝົດລ້ວນແຕ່ເຮັດວຽກຄືກັນຢູ່ເບື້ອງຫຼັງ:

1. ຮັບຄີ API

ໃນແຜງໜ້າປັດຂອງທ່ານ, ໃຫ້ໄປທີ່ API keys ແລະ ສ້າງຂຶ້ນມາໃໝ່ອັນໜຶ່ງ. ໃຫ້ກຳນົດສິດສະເພາະເທົ່າທີ່ຈຳເປັນເທົ່ານັ້ນ:

⛔ ຫ້າມໃຫ້ສິດ reseller.manage ແກ່ລະບົບເຊື່ອມຕໍ່ເດັດຂາດ. ການອະນຸຍາດນັ້ນຈະແກ້ໄຂລາຍການລາຄາຂອງທ່ານ ແລະ ຂໍ້ມູນປະຈຳຕົວຂອງປະຕູຊຳລະເງິນຂອງທ່ານເອງ. reseller.provision ຖືກສ້າງຂຶ້ນມາໂດຍສະເພາະເພື່ອໃຫ້ຄີທີ່ທ່ານວາງລົງໃນແຜງຮຽກເກັບເງິນ ຫຼື ເວັບໄຊ ບໍ່ຈຳເປັນຕ້ອງໃຊ້ສິດດັ່ງກ່າວ.

ຄີຈະສະແດງພຽງຄັ້ງດຽວເທົ່ານັ້ນ. ໃຫ້ເກັບຮັກສາມັນໄວ້ໃນບ່ອນທີ່ທ່ານເກັບຂໍ້ມູນປະຈຳຕົວອື່ນໆຂອງທ່ານ — ຫ້າມເກັບໄວ້ໃນໄຟລ໌ທີ່ເວັບເຊີບເວີຂອງທ່ານເຜີຍແຜ່ເດັດຂາດ.

2. ທົດລອງເອີ້ນໃຊ້ງານຄັ້ງທຳອິດຂອງທ່ານ

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

ຄຳສັ່ງດັ່ງກ່າວຈະສົ່ງຄ່າການບໍລິການທັງໝົດທີ່ທ່ານໄດ້ຈັດສັນໄວ້, ໜຶ່ງແຖວຕໍ່ໜຶ່ງເວັບໄຊ, ພ້ອມທັງລູກຄ້າທີ່ເປັນເຈົ້າຂອງ, ສະຖານະ, ແລະ ລາຄາທີ່ທ່ານຮຽກເກັບ. ໃນບັນຊີໃໝ່ ມັນຈະສະແດງເປັນລາຍການວ່າງເປົ່າ — ເຊິ່ງເປັນຄຳຕອບທີ່ຖືກຕ້ອງ, ບໍ່ແມ່ນຂໍ້ຜິດພາດ.

3. ການເຊື່ອມຕໍ່ທັງໝົດ, ໃນການເອີ້ນໃຊ້ງານຫົກຄັ້ງ

ເມື່ອໃດ                ການເອີ້ນໃຊ້ງານ
ມີການຈ່າຍເງິນຄຳສັ່ງຊື້     POST   /v1/orgs                                   ໜຶ່ງຄັ້ງຕໍ່ ລູກຄ້າ
                     POST   /v1/sites                                  ໜຶ່ງຄັ້ງຕໍ່ ການບໍລິການ
ພວກເຂົາຍັງບໍ່ໄດ້ຈ່າຍເງິນ   POST   /v1/reseller/services/{siteId}/suspend
ພວກເຂົາຈ່າຍເງິນ       POST   /v1/reseller/services/{siteId}/unsuspend
ພວກເຂົາຍົກເລີກ        DELETE /v1/sites/{siteId}
"ເຂົ້າສູ່ລະບົບໂຮສຕິ້ງ"   POST   /v1/reseller/services/{siteId}/sso

ການຈັດສັນລະບົບປະກອບດ້ວຍການເອີ້ນໃຊ້ງານສອງຄັ້ງ, ແລະ ຄ່າຄີຕ່າງໆມີຄວາມສຳຄັນ:

# 1. ບັນຊີຂອງລູກຄ້າ — ກຳນົດຄີຕາມລະຫັດລູກຄ້າຂອງທ່ານເອງ
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. ເວັບໄຊຂອງພວກເຂົາ — ກຳນົດຄີຕາມລະຫັດການບໍລິການຂອງທ່ານເອງ
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"}'

ສອງກົດລະບຽບທີ່ອາດເຮັດໃຫ້ທ່ານເສຍເງິນຫາກປະຕິບັດຜິດພາດ

1. ກຳນົດຄີບັນຊີຕາມ ລູກຄ້າ ຂອງທ່ານ ແລະ ກຳນົດຄີເວັບໄຊຕາມ ການບໍລິການ ຂອງທ່ານ. ຄຳສັ່ງຊື້ທີສອງຂອງລູກຄ້າຈະຕ້ອງເຂົ້າໄປຢູ່ໃນບັນຊີທີ່ພວກເຂົາມີຢູ່ແລ້ວ. ຫາກກຳນົດຄີທັງສອງຢ່າງຕາມການບໍລິການ, ລູກຄ້າຄົນດຽວຈະກາຍເປັນວ່າມີສາມບັນຊີທີ່ບໍ່ກ່ຽວຂ້ອງກັນ ແລະ ມີສາມແຜງຄວບຄຸມແຍກຕ່າງຫາກ.
2. ສົ່ງ Idempotency-Key ໃນທຸກໆ POST, ໂດຍສ້າງຂຶ້ນມາຈາກລະຫັດສະເພາະຂອງທ່ານເອງສຳລັບລາຍການນັ້ນ. ທຸກໆລະບົບການຮຽກເກັບເງິນຈະມີການລອງໃໝ່ — ການຕອບກັບຈາກປະຕູຊຳລະເງິນສົ່ງມາສອງເທື່ອ, ຜູ້ເບິ່ງແຍງລະບົບກົດດຳເນີນການຈັດສັນທີ່ຫຼົ້ມເຫຼວອີກຄັ້ງ, ລູກຄ້າກົດດັບເບິນຄລິກ. ຫາກບໍ່ມີຄີນີ້, ຄວາມພະຍາຍາມຄັ້ງທີສອງຈະສ້າງເວັບໄຊທີສອງຂຶ້ນມາ ແລະ ທ່ານຈະຖືກຮຽກເກັບເງິນສຳລັບເວັບໄຊນັ້ນ.

ສາມຄຳຕອບທີ່ທ່ານບໍ່ຄວນມອງຂ້າມ ຫຼື ເໝົາລວມເຂົ້າກັນ

• unsuspend ສາມາດຕອບກັບເປັນ 409 ໄດ້. ນັ້ນໝາຍຄວາມວ່າທີມງານກວດສອບການລະເມີດຂອງພວກເຮົາເປັນຜູ້ລະງັບເວັບໄຊໄວ້, ບໍ່ແມ່ນທ່ານ. ໃຫ້ສະແດງຂໍ້ຄວາມແຈ້ງເຕືອນ; ຫ້າມລອງໃໝ່.
• **ການຍົກເລີກ (Terminating) ເປັນພຽງການ ກຳນົດເວລາ ການລຶບ, ບໍ່ແມ່ນການລຶບໃນທັນທີ.** ວັນທີ່ຈະຖືກສົ່ງກັບມາເປັນ pending_deletion_at. ການບອກລູກຄ້າວ່າຂໍ້ມູນຂອງພວກເຂົາຖືກລຶບໄປແລ້ວທັງທີ່ຕົວຈິງຍັງບໍ່ຖືກລຶບ ແມ່ນຮ້າຍແຮງກວ່າການບໍ່ບອກຫຍັງເລີຍ.
• disk_used_bytes ສາມາດມີຄ່າເປັນ null ໄດ້, ແລະ null ບໍ່ແມ່ນສູນ. ມັນໝາຍຄວາມວ່າພວກເຮົາບໍ່ສາມາດວັດແທກໄດ້, ບໍ່ໄດ້ໝາຍຄວາມວ່າບໍ່ມີການນຳໃຊ້ເລີຍ. ໃຫ້ຂ້າມມັນໄປ — ຫ້າມຂຽນ 0 ລົງໃນບັນທຶກຂອງທ່ານເອງ, ບໍ່ດັ່ງນັ້ນທ່ານຈະສະແດງແຖບການນຳໃຊ້ສີຂຽວໃຫ້ລູກຄ້າເຫັນ ສຳລັບເວັບໄຊທີ່ທ່ານບໍ່ມີຄ່າການອ່ານຂໍ້ມູນໃດໆ.

4. ການນຳລູກຄ້າເຂົ້າສູ່ລະບົບ

POST /v1/reseller/services/{siteId}/sso ຈະສົ່ງຄືນ URL ທີ່ໃຊ້ໄດ້ພຽງຄັ້ງດຽວ ເຊິ່ງຈະນຳລູກຄ້າຂອງທ່ານເຂົ້າສູ່ບັນຊີຂອງພວກເຂົາໂດຍກົງ, ໃນສະຖານະທີ່ເຂົ້າສູ່ລະບົບຮຽບຮ້ອຍແລ້ວ.

⛔ ໃຫ້ສ້າງມັນຂຶ້ນເມື່ອພວກເຂົາຄລິກເທົ່ານັ້ນ, ຫ້າມສ້າງໃນຕອນທີ່ທ່ານກຳລັງສະແດງຜົນໜ້າເວັບ. ລິ້ງດັ່ງກ່າວໃຊ້ໄດ້ພຽງຄັ້ງດຽວ ແລະ ຈະໝົດອາຍຸພາຍໃນບໍ່ເທົ່າໃດນາທີ, ດັ່ງນັ້ນລິ້ງທີ່ຖືກຂຽນຝັງລົງໃນໜ້າເວັບຈະຖືກໃຊ້ງານໄປຕັ້ງແຕ່ການເປີດເບິ່ງໜ້າເວັບຄັ້ງທຳອິດ ແລະ ຕົກຄ້າງຢູ່ໃນທຸກແຄຊ໌ລະຫວ່າງທ່ານກັບບຣາວເຊີ.

5. ຕິດຕັ້ງໂມດູນແທນ

• WHMCS — ສຳເນົາໂມດູນໄປທີ່ modules/servers/zinn/, ເພີ່ມເຊີບເວີທີ່ມີ Password ເປັນຄີ API ຂອງທ່ານ, ແລະ ກຳນົດສາຍຜະລິດຕະພັນໃນຕົວຜະລິດຕະພັນ. ກົດ Test Connection: ມັນຈະທຳການເອີ້ນໃຊ້ງານຕົວຈິງ ແລະ ບອກທ່ານວ່າແພລດຟອມຕອບກັບແນວໃດ.
• HostBill — ສຳເນົາໄປທີ່ includes/modules/Hosting/zinn/ ແລະ ເຊື່ອມຕໍ່ໃນຮູບແບບດຽວກັນ.
• WordPress — Zinn® Reseller Toolkit: ການຄົ້ນຫາໂດເມນ, ລິ້ງເຂົ້າສູ່ລະບົບໂຮສຕິ້ງຂອງລູກຄ້າຂອງທ່ານ, ແລະ ການຈັດສັນລະບົບ WooCommerce ເມື່ອຄຳສັ່ງຊື້ໄດ້ຮັບການຊຳລະເງິນແລ້ວ. ເປັນໂອເພນຊອຣ໌ສທີ່ <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ຫຼື ດາວໂຫຼດໄດ້ຈາກ Plugins ໃນແຜງໜ້າປັດຂອງທ່ານ.

6. ເລີ່ມເປີດໃຊ້ງານຈິງ

ກວດສອບສິ່ງເຫຼົ່ານີ້ກ່ອນທີ່ທ່ານຈະຮັບຄຳສັ່ງຊື້ຕົວຈິງ:

• ການທົດສອບການເຊື່ອມຕໍ່ຜ່ານໂມດູນສຳເລັດແລ້ວ, ຫຼື ຄຳສັ່ງ curl ທຳອິດຂອງທ່ານສົ່ງຄືນລາຍການອອກມາ.
• ລາຍການລາຄາຂອງທ່ານຖືກຕັ້ງຄ່າຮຽບຮ້ອຍແລ້ວ (Reselling → Your prices).
• ປະຕູຊຳລະເງິນຂອງທ່ານຖືກເຊື່ອມຕໍ່ແລ້ວ (Reselling → Payment gateways) — ລູກຄ້າຈ່າຍເງິນໃຫ້ທ່ານ, ຜ່ານບັນຊີຂອງທ່ານເອງ.
• ຂໍ້ມູນລາຍລະອຽດບໍລິສັດຂອງທ່ານຖືກປ້ອນເຂົ້າແລ້ວ (Reselling → Your company) ເພື່ອໃຫ້ໃບແຈ້ງໜີ້ຂອງລູກຄ້າສະແດງຊື່ນິຕິບຸກຄົນ ແລະ ເລກປະຈຳຕົວຜູ້ເສຍພາສີມູນຄ່າເພີ່ມຂອງທ່ານ, ບໍ່ແມ່ນຂອງພວກເຮົາ.
• ທ່ານໄດ້ທົດລອງສັ່ງຊື້ຕົວຈິງຄົບທຸກຂັ້ນຕອນແລ້ວໜຶ່ງຄັ້ງ ແລະ ເຫັນເວັບໄຊປະກົດຂຶ້ນມາແລ້ວ.

ແຫຼ່ງຂໍ້ມູນອື່ນໆທັງໝົດ

ເອກະສານອ້າງອີງ API ທີ່ສົມບູນ — ທຸກໆຈຸດເຊື່ອມຕໍ່ (endpoint), ທີ່ຖືກສ້າງຂຶ້ນຈາກຂໍ້ກຳນົດສະເພາະຂອງພວກເຮົາ, ພ້ອມດ້ວຍສິດການອະນຸຍາດທີ່ແຕ່ລະຈຸດຕ້ອງການ — ສາມາດເຂົ້າເບິ່ງໄດ້ທີ່ <https://zinndigital.com/developers/api>.