O'z tizimlaridan Zinn® xostingini sotish

Siz bizning hostingimizni qayta sotasiz. Mijozlar sizniki: narxlaringiz, hisob-fakturalaringiz va to'lov provayderingiz ham o'zingizniki. Platformamizni mavjud tizimingiz — billing paneli, o'z WordPress saytingiz yoki skript orqali boshqarishingiz mumkin.

Mijozlaringiz aslida nimani ko'radi

Texnik tafsilotlardan oldin: mijozlaringiz bizni hech qachon ko'rmaydi. Uchta interfeys mavjud va qaysi biridan foydalanishni o'zingiz tanlaysiz.

| Interfeys | Kimga tegishli | |---|---| | O'z domen nomingizdagi hosting paneli | Qayta sotish → Sizning brendingiz bo'limida panel domen nomini o'rnating va mijozlaringiz panel.yourcompany.com manzilida o'z logotipingiz va ranglaringiz bilan tizimga kirishadi. Panel o'sha-o'sha, lekin manzil sizniki. | | O'z veb-saytingiz | WordPress plagin saytingizga domen qidiruvi va bir marta bosish orqali kirish havolasini qo'shadi hamda buyurtmani o'z WooCommerce kassangiz orqali qabul qiladi. | | Billing panelingiz | WHMCS yoki HostBill asosiy eshik bo'lib qoladi; modul orqada turib xizmatni faollashtiradi va mijozlar zonasidagi tugma ularni to'g'ridan-to'g'ri o'z hostingiga kirishini ta'minlaydi. |

⛔ Qaysi birini tanlamang, mijozlaringiz oldida rasmiy sotuvchi o'zingiz bo'lasiz: narxlaringiz, hisob-fakturalaringiz, QQS raqamingiz va to'lov provayderingiz o'zingizniki. Biz sizga har oyda bir marta ulgurji narxda hisob-faktura yuboramiz.

Panel domen nomini o'rnatganingizdan so'ng, uni faqat WordPress plaginining Panel manzili maydoniga kiriting va boshqa hech qayerga yozmang — ushbu API yaratgan kirish havolalari shunga mos ravishda avtomatik ishlaydi.

Kirishning to'rt xil usuli

Tizimga kirishning to'rt xil usuli mavjud bo'lib, ularning barchasi ostida bir xil vazifani bajaradi:

| | Uchun | |---|---| | WHMCS moduli | WHMCS do'koni | | HostBill moduli | HostBill do'koni | | WordPress plugini | O'z WordPress yoki WooCommerce saytingizdan sotish | | API | Boshqa har qanday tizim — Blesta, ichki tizim, cron skripti |

1. API kalitini oling

Boshqaruv panelingizdagi API keys bo'limiga o'ting va kalit yarating. Unga faqat kerakli huquqlarni bering:

| Ruxsat | Nima uchun | |---|---| | org.read | Mijoz akkauntlarini o'qish | | sites.create | Saytni faollashtirish | | sites.view | Xizmatni o'qish | | sites.delete | To'xtatish | | reseller.view | Xizmatlaringiz ro'yxatini ko'rish va foydalanishni o'qish | | reseller.provision | Mijozni vaqtincha to'xtatish, faollashtirish va tizimga kiritish |

⛔ Integratsiyaga reseller.manage huquqini bermang. Ushbu ruxsat narxlar ro'yxati va o'zingizning to'lov shlyuzi ma'lumotlarini tahrirlaydi. reseller.provision billing paneliga yoki veb-saytga kiritadigan kalitingiz bunga muhtoj bo'lmasligi uchun maxsus yaratilgan.

Kalit bir marta ko'rsatiladi. Uni boshqa maxfiy ma'lumotlaringizni saqlaydigan joyda saqlang — veb-serveringiz ochib beradigan fayllarda aslo saqlamang.

2. Birinchi so'rovingizni yuboring

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

Bu siz faollashtirgan har bir xizmatni, har bir sayt uchun bitta qatordan, unga tegishli mijoz, uning holati va buning uchun belgilangan narxingiz bilan birga qaytaradi. Yangi akkauntda bu bo'sh ro'yxat bo'ladi — bu xato emas, to'g'ri javob hisoblanadi.

3. To'liq integratsiya, oltita so'rovda

QACHON                 SO'ROV
buyurtma to'langanda   POST   /v1/orgs                                   har bir MIJOZ uchun bir marta
                       POST   /v1/sites                                  har bir XIZMAT uchun bir marta
ular to'lamagan bo'lsa POST   /v1/reseller/services/{siteId}/suspend
ular to'laganda        POST   /v1/reseller/services/{siteId}/unsuspend
ular bekor qilganda    DELETE /v1/sites/{siteId}
"hostingga kirish"     POST   /v1/reseller/services/{siteId}/sso

Faollashtirish ikkita so'rovdan iborat bo'lib, kalitlar muhim rol o'ynaydi:

# 1. mijozning akkaunti — SIZNING mijoz ID raqamingizga asoslangan
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. ularning sayti — SIZning xizmat ID raqamingizga asoslangan
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"}'

Xato qilsangiz qimmatga tushadigan ikkita qoida

Akkauntni MIJOZINGIZ asosida va saytni XIZMATINGIZ asosida belgilang. Mijozning ikkinchi buyurtmasi u allaqachon mavjud bo'lgan akkauntga tushishi kerak. Ikkalasini ham xizmat asosida belgilasangiz, bitta mijoz uchta o'zaro bog'liq bo'lmagan akkaunt va uchta alohida panelga ega bo'lib qoladi.
Har bir POST so'rovida narsaning o'z ID raqamidan yasalgan Idempotency-Key jo'nating. Har qanday billing tizimi qayta urinib ko'radi — shlyuz qayta qo'ng'irog'i ikki marta keladi, admin muvaffaqiyatsiz faollashtirishni qayta ishga tushiradi, mijoz ikki marta bosib yuboradi. Kalitsiz amalga oshirilgan ikkinchi urinish ikkinchi saytni yaratadi va buning uchun sizga haq yoziladi.

Ikkita holatga keltirib bo'lmaydigan uchta javob

unsuspend so'rovi 409 javobini qaytarishi mumkin. Bu bizning qoidabuzarliklar bo'yicha jamoamiz saytni bloklaganini anglatadi, sizni emas. Xabarni ko'rsating; qayta urinib ko'rmang.
**To'xtatish rejalashtirilgan o'chirishni bildiradi, u darhol o'chirib yubormaydi.** Sana pending_deletion_at sifatida qaytariladi. Mijozga ma'lumotlari hali o'chmagan bo'lsa ham, ular yo'q bo'lib ketganini aytish ularga umuman hech narsa demasdan yomonroqdir.
disk_used_bytes qiymati null bo'lishi mumkin va null nolga teng emas. Bu biz o'lchay olmaganimizni anglatadi, hech narsa ishlatilmaganini emas. Uni o'tkazib yuboring — o'z yozuvlaringizga 0 deb yozmang, aks holda hech qanday ma'lumot olmagan saytingiz uchun mijozga yashil foydalanish panelini ko'rsatib qo'yasiz.

4. Mijozni tizimga kiriting

POST /v1/reseller/services/{siteId}/sso so'rovi mijozingizni tizimga allaqachon kirgan holda to'g'ridan-to'g'ri o'z akkauntiga olib boradigan bir martalik URL manzilini qaytaradi.

⛔ Uni sahifani ochganingizda emas, balki mijoz bosganda yarating. Havola bir martalik bo'lib, bir necha daqiqa ichida amal qilish muddati tugaydi, shuning uchun sahifaga yozib qo'yilgan havola birinchi sahifa ko'rilishidayoq yaroqsiz holatga keladi va siz bilan brauzer orasidagi har qanday keshda qolib ketadi.

5. Buning o'rniga modulni o'rnating

WHMCS — modulni modules/servers/zinn/ papkasiga ko'chirib o'tkazing, Password maydoniga API kalitingiz kiritilgan server qo'shing va mahsulot liniyasini o'rnating. Test Connection tugmasini bosing: u haqiqiy so'rov yuboradi va platforma nima deganini sizga ko'rsatadi.
HostBill — includes/modules/Hosting/zinn/ papkasiga ko'chiring va xuddi shunday tarzda ulang.
WordPress — Zinn® Reseller Toolkit: domen qidiruvi, mijozlaringiz hostingiga kirish havolasi va buyurtma to'langanda WooCommerce orqali faollashtirish. Ochiq kodli versiyasi <https://github.com/Zinn-Digital/zinn-reseller-toolkit> manzilida yoki boshqaruv panelingizdagi Plugins bo'limidan yuklab oling.

6. Ishga tushiring

Haqiqiy buyurtmani qabul qilishdan oldin quyidagilarni tekshiring:

Modulda ulanish testi muvaffaqiyatli o'tmoqda yoki birinchi curl so'rovingiz ro'yxat qaytarmoqda.
Narxlar ro'yxatingiz o'rnatilgan (Qayta sotish → Narxlaringiz).
To'lov shlyuzingiz ulangan (Qayta sotish → To'lov shlyuzlari) — mijozlaringiz o'z akkauntingiz orqali sizga to'lov qilmoqda.
Kompaniyangiz ma'lumotlari kiritilgan (Qayta sotish → Sizning kompaniyangiz), shuning uchun mijozingizning hisob-fakturalari bizning emas, balki sizning yuridik shaxsingiz va QQS raqamingizni ko'rsatib turadi.
Haqiqiy buyurtmani boshidan oxirigacha bitta joylashtirib ko'rdingiz va sayt paydo bo'lganini kuzatdingiz.

Boshqa barcha ma'lumotlar qayerda

To'liq API qo'llanmasi — har bir yakuniy nuqta (endpoint), bizning spetsifikatsiyamizdan yaratilgan va har biri talab qiladigan ruxsatlar bilan birga — <https://zinndigital.com/developers/api> manzilida joylashgan.