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

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

ສິ່ງທີ່ລູກຄ້າຂອງທ່ານເຫັນແທ້ໆ

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

| ສ່ວນ | ເປັນຂອງໃຜ | |---|---| | ແຜງໂຮດຕິ້ງ, ໃນ host name ຂອງທ່ານເອງ | ຕັ້ງຄ່າ host name ຂອງແຜງຢູ່ກຸ່ມ Reselling → Your brand ແລະ ລູກຄ້າຂອງທ່ານຈະເຂົ້າສູ່ລະບົບຢູ່ panel.yourcompany.com ດ້ວຍໂລໂກ້ ແລະ ສີສັນຂອງທ່ານ. ແຜງດຽວກັນ, ທີ່ຢູ່ຂອງທ່ານ. | | ເວັບໄຊຂອງທ່ານເອງ | ປລັກອິນ WordPress ຈະເພີ່ມການຄົ້ນຫາໂດເມນ ແລະ ລິ້ງເຂົ້າສູ່ລະບົບແບບຄລິກດຽວໃສ່ໃນເວັບໄຊຂອງທ່ານ, ແລະ ຮັບຄຳສັ່ງຊື້ຜ່ານລະບົບຊຳລະເງິນ WooCommerce ຂອງທ່ານເອງ. | | ແຜງເກັບເງິນຂອງທ່ານ | WHMCS ຫຼື HostBill ຍັງຄົງເປັນໜ້າຕ່າງຫຼັກ; ໂມດູນຈະຈັດສັນຢູ່ທາງຫຼັງ ແລະ ປຸ່ມໃນສ່ວນຂອງລູກຄ້າຈະພາພວກເຂົາເຂົ້າສູ່ໂຮດຕິ້ງໂດຍກົງ. |

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

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

4 ວິທີໃນການເຂົ້າໃຊ້

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

| | ສຳລັບ | |---|---| | ໂມດູນ WHMCS | ຮ້ານຄ້າ WHMCS | | ໂມດູນ HostBill | ຮ້ານຄ້າ HostBill | | ປລັກອິນ WordPress | ການຂາຍຈາກເວັບໄຊ WordPress ຫຼື WooCommerce ຂອງທ່ານເອງ | | API | ສິ່ງອື່ນໆ — Blesta, ລະບົບພາຍໃນ, ສະຄຣິບ cron |

1. ຮັບ API key

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

| ການອະນຸມັດ | ເຫດຜົນ | |---|---| | org.read | ອ່ານບັນຊີລູກຄ້າຂອງທ່ານ | | sites.create | ຈັດສັນເວັບໄຊ | | sites.view | ອ່ານຂໍ້ມູນບໍລິການ | | sites.delete | ຍົກເລີກ | | reseller.view | ສະແດງລາຍການບໍລິການຂອງທ່ານ ແລະ ອ່ານການໃຊ້ງານ | | reseller.provision | ລະງັບ, ປົດລະງັບ, ແລະ ເຂົ້າສູ່ລະບົບໃຫ້ລູກຄ້າ |

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

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

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

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

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

3. ການເຊື່ອມໂຍງທັງໝົດ, ໃນການເອີ້ນໃຊ້ 6 ຄັ້ງ

WHEN                 CALL
an order is paid     POST   /v1/orgs                                   once per CUSTOMER
                     POST   /v1/sites                                  once per SERVICE
they have not paid   POST   /v1/reseller/services/{siteId}/suspend
they pay             POST   /v1/reseller/services/{siteId}/unsuspend
they cancel          DELETE /v1/sites/{siteId}
"log in to hosting"  POST   /v1/reseller/services/{siteId}/sso

ການຈັດສັນແມ່ນການເອີ້ນໃຊ້ສອງຄັ້ງ, ແລະ key ຖືເປັນສິ່ງ ສຳຄັນ:

# 1. the customer's account — keyed on YOUR 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. their site — keyed on YOUR 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"}'

ກົດສອງຂໍ້ທີ່ຈະເຮັດໃຫ້ເສຍເງິນຖ້າທ່ານເຮັດຜິດ

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

ຄຳຕອບສາມຢ່າງທີ່ທ່ານຕ້ອງບໍ່ລວມໃຫ້ເຫຼືອສອງຢ່າງ

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

4. ເຂົ້າສູ່ລະບົບໃຫ້ລູກຄ້າ

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

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

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

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

6. ເລີ່ມໃຊ້ງານແທ້

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

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

ບ່ອນທີ່ສິ່ງອື່ນໆທັງໝົດຢູ່

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