Фурӯши хостинги 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. ҳисоби муштарӣ — бо 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/ нусхабардорӣ кунед, сервереро илова намоед, ки 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 — ҳар як нуқтаи ниҳоӣ, ки аз мушаххасоти мо тавлид шудааст, бо иҷозатномае, ки ҳар кадоме талаб мекунад — дар <https://zinndigital.com/developers/api> ҷойгир аст.