Фурӯши мизбонии Zinn® аз системаҳои худ

Шумо мизбонии моро аз нав мефурӯшед. Мизоҷони шумо аз худи шумо ҳастанд: нархҳо, ҳисобнома-фактураҳо ва провайдери пардохти шумо. Ин аст тарзи идора кардани платформаи мо аз ҳар коре, ки аллакай кор мекунад — панели ҳисобдорӣ, сайти шахсии WordPress ё як скрипт.

Мизоҷони шумо дар асл чӣ мебинанд

Пеш аз механизмҳо: мизоҷони шумо ҳеҷ гоҳ набояд моро бубинанд. Се сатҳ вуҷуд дорад ва шумо интихоб мекунед, ки кадоме аз онҳоро истифода мебаред.

| Сатҳ | Аз кӣ аст | |---|---| | Панели мизбонӣ, дар номи мизбони худи шумо | Номи мизбони панелро дар зери Бознифурӯшӣ → Бренд ё тамғаи шумо танзим кунед ва мизоҷони шумо бо логотип ва рангҳои шумо ба panel.yourcompany.com ворид мешаванд. Ҳамон панел, суроғаи шумо. | | Вебсайти шахсии шумо | Плагини WordPress ҷустуҷӯи домен ва истиноди воридшавии бо як кликро ба сайти шумо ҷойгир мекунад ва фармоишро тавассути ҳисобкитоби WooCommerce-и худи шумо қабул мекунад. | | Панели ҳисобдории шумо | WHMCS ё HostBill ҳамчун дари пеш боқӣ мемонад; модул дар паси он пешниҳод мекунад ва тугмаи минтақаи мизоҷ онҳоро бевосита ба мизбонии онҳо ворид мекунад. |

⛔ Ҳар кадомеро, ки интихоб кунед, шумо тоҷири сабти мизоҷони худ ҳастед: нархҳои шумо, ҳисобнома-фактураҳои шумо, рақами ҚҚС (VAT)-и шумо, провайдери пардохти шумо. Мо ба шумо як маротиба дар як моҳ бо нархи яклухт ҳисоб пешниҳод мекунем.

Пас аз он ки шумо номи мизбони панелро таъин кардед, онро дар майдони Суроғаи панел-и плагини WordPress гузоред ва дар ягон ҷои дигар не — истинодҳои воридшавӣ, ки ин API тавлид мекунад, ба таври худкор аз паси он мераванд.

Чор роҳи даромад

Чор роҳи даромад вуҷуд дорад ва ҳамаи онҳо дар зери он як корро мекунанд:

| | Барои | |---|---| | Модули WHMCS | Дӯкони WHMCS | | Модули HostBill | Дӯкони HostBill | | Плагини WordPress | Фурӯш аз сайти шахсии WordPress ё WooCommerce | | API | Ҳар чизи дигар — Blesta, системаи дохилӣ, скрипти cron |

1. Гирифтани калиди API

Дар панели идоракунии худ, ба Калидҳои API гузаред ва якеро созед. Танҳо он чизеро, ки лозим аст, ба он диҳед:

| Иҷрозат (Иҷозатнома) | Чаро | |---|---| | org.read | Ҳисобҳои мизоҷони худро хонед | | sites.create | Пешниҳоди сайт | | sites.view | Хондани хизматрасонӣ | | sites.delete | Қатъ кардан | | reseller.view | Феҳристи хизматрасониҳо ва хондани истифода | | reseller.provision | Боздоштан, озод кардан ва ворид кардани мизоҷ |

⛔ Ба интегратсия 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. ҳисоби мизоҷ — калид бо рақами шиносаи (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. сайти онҳо — калид бо рақами шиносаи (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. Барои ҳисоб МИЗОҶИ худ ва барои сайт ХИЗМАТРАСОНИИ худро калид кунед. Фармоиши дуюми мизоҷ бояд ба ҳисобе расад, ки онҳо аллакай доранд. Ҳардуро дар хизматрасонӣ калид кунед ва як мизоҷ бо се ҳисоби бегона ва се панели алоҳида ба охир мерасад.
2. Барои ҳар як POST Idempotency-Key фиристед, ки аз рақами шиносаи (ID) худи шумо барои он чиз сохта шудааст. Ҳар як системаи ҳисобдорӣ такрор мекунад — бозгашти шлюз ду маротиба меояд, мудир пешниҳоди нокомро дубора иҷро мекунад, мизоҷ ду маротиба клик мекунад. Бе ин калид кӯшиши дуюм сайфи дуюмро эҷод мекунад ва барои он аз шумо маблағ талаб карда мешавад.

Се ҷавобе, ки шумо набояд ба ду ҷавоб ҳамвор кунед

• unsuspend метавонад 409-ро ҷавоб диҳад. Ин маънои онро дорад, ки гурӯҳи суиистифодаи мо сайт дорад, на шумо. Паёмро нишон диҳед; онро дубора такрор накунед.
• **Қатъкунӣ несткуниро ба нақша мегирад, он онро иҷро намекунад.** Сана ҳамчун pending_deletion_at бармегардад. Ба мизоҷ гуфтан, ки маълумоти онҳо аллакай нест шудааст, дар ҳоле ки нест, аз ба ҳеҷ чиз нагуфтан бадтар аст.
• disk_used_bytes метавонад null бошад ва null сифр нест. Ин маънои онро дорад, ки мо ҳисоб карда натавонистему чен карда натавонистем, на ин ки ягон чиз истифода нашудааст. Онро гузаред — 0-ро ба сабтҳои худ нависед, вагарна шумо ба мизоҷ сатри сабзи истифодаро барои сайте нишон медиҳед, ки шумо аз он ҳеҷ гуна хониш надоред.

4. Ворид кардани мизоҷ

POST /v1/reseller/services/{siteId}/sso суроғаи URL-и яквақтаеро бармегардонад, ки мизоҷи шуморо мустақиман ба ҳисоби худ, ки аллакай ворид шудааст, мепартояд.

⛔ Онро ҳангоми клик кардани онҳо созед, ҳеҷ гоҳ ҳангоми сохтани саҳифа. Истинод яквақта аст ва пас аз чанд дақиқа мӯҳлаташ тамом мешавад, аз ин рӯ истиноде, ки дар саҳифа навишта шудааст, ҳангоми дидани саҳифаи аввал месӯзад ва дар ҳар як кэши байни шумо ва браузер боқӣ мемонад.

5. Ба ҷои ин модулеро насб кунед

• WHMCS — модулро ба modules/servers/zinn/ нусхабардорӣ кунед, сервереро илова кунед, ки Парол (Рамзи убур)-и он калиди API-и шумо аст ва хати маҳсулотро дар маҳсулот танзим кунед. Тугмаи Санҷиши пайвастшавӣ (Test Connection)-ро пахш кунед: он даъвати воқеӣ мекунад ва ба шумо мегӯяд, ки платформа чӣ гуфт.
• HostBill — ба includes/modules/Hosting/zinn/ нусхабардорӣ кунед ва онро ҳамин тавр пайваст кунед.
• WordPress — Zinn® Reseller Toolkit: ҷустуҷӯи домен, истиноди воридшавӣ ба мизбонии мизоҷони шумо ва пешниҳоди WooCommerce ҳангоми пардохти фармоиш. Сарчашмаи кушода (Open source) дар <https://github.com/Zinn-Digital/zinn-reseller-toolkit> ё онро аз Плагинҳо дар панели идоракунии худ зеркашӣ кунед.

6. Ба кор даровардан (Go live)

Пеш аз қабули фармоиши воқеӣ инҳоро санҷед:

• Санҷиши пайвастшавӣ дар модул мегузарад ё curl-и аввалини шумо рӯйхатро бармегардонад.
• Рӯйхати нархҳои шумо танзим шудааст (Бознифурӯшӣ → Нархҳои шумо).
• Шлюзи пардохти шумо пайваст шудааст (Бознифурӯшӣ → Шлюзҳои пардохт) — мизоҷони шумо ба шумо тавассути ҳисоби худатон пардохт мекунанд.
• Маълумоти ширкати шумо ворид карда шудааст (Бознифурӯшӣ → Ширкати шумо), то ки ҳисобнома-фактураҳои мизоҷони шумо шахсияти ҳуқуқӣ ва рақами ҚҚС (VAT)-и шуморо дошта бошанд, на мо.
• Шумо як фармоиши воқеиро аз аввал то охир ҷойгир кардаед ва пайдо шудани сайтро тамошо кардаед.

Ҳама чизҳои дигар дар куҷо ҳастанд

Маълумотномаи мукаммали API — ҳар як нуқтаи ниҳоӣ (endpoint), ки аз мушаххасоти мо бо иҷрозати ҳар кадоме ниёз дорад, тавлид шудааст, дар <https://zinndigital.com/developers/api> ҷойгир аст.