Iibinta kaydinta Zinn® ee nidaamyadaada gaarka ah

Waxaad dib u iibisa macaamiisha hosting-ka. Macaamiishaadu waa kuwaaga: qiimayaashaada, biilashaada, bixiyahaaga lacag-bixinta. Sidan ayaad uga wadddaa barnaamijkayaga meel kasta oo aad horey uga wadaysey — guddi biilasha, bogagaaga WordPress ee kuu gaarka ah, ama qoraal (script).

Waxa ay macaamiishaadu dhab ahaantii arkaan

Intaan la gaarin farsamada: macaamiishaadu ma aha inay na arkaan weligood. Saddex oogood, oo aad adigu dooranayso midka aad isticmaalayso.

| Oogga | Kii leh | |---|---| | Guddiga hosting-ka, oo ku yaal magacaaga martida (hostname) | Ku deji magaca martida ee guddiga hoostiisa Dib-u-iibinta → Summadaada macaamiishaaduna waxay ku soo galaan panel.yourcompany.com oo wata astaantaada iyo midabadaada. Guddigii oo kale ah, cinwaankaaga. | | Mareegahaaga | Ku-xidhaha WordPress wuxuu geliyaa raadinta domainka iyo xiriirka gelitaanka ee hal-gujis ah mareegahaaga, wuxuuna ku qaadaa dalabka hubinta WooCommerce ee kuu gaarka ah. | | Guddigaaga biilasha | WHMCS ama HostBill ayaa ah albaabka hore; qaybtu waxay soo saartaa gadaasheeda badhanka aagga macaamiishuna wuxuu si toos ah ugu dhex galaa hosting-kooda. |

⛔ Meel kasta oo aad doorato, waxaad tahay ganacsadaha diiwaanka u ah macaamiishaada: qiimayaashaada, biilashaada, lambarkaaga VAT, bixiyahaaga lacag-bixinta. Waxaan ku biilaynaa adiga, hal mar bishii, sicirka jumlada ah.

Markaad dejiso magaca martida ee guddiga, geli goobta cinwaanka guddiga ee ku-xidhaha WordPress ee aan wax kale ahayn — xiriiriyeyaasha gelitaanka ee API-gan soo saaro ayaa si toos ah u raaca.

Afarta waddo ee loo galo

Waxaa jira afar waddo oo lagu galo, dhammaantoodna waxay sameeyaan wax la mid ah hoosta:

| | Loogu talagalay | |---|---| | Qaybta WHMCS | Dukaanka WHMCS | | Qaybta HostBill | Dukaanka HostBill | | Ku-xidhaha WordPress | Ka iibinta WordPress ama dukaanka WooCommerce ee adiga kuu gaar ah | | API-ga | Wax kasta oo kale — Blesta, nidaam gudaha ah, qoraal cron ah |

1. Hel furaha API-ga

Guddigaaga maamulka, aad Furayaasha API-ga oo abuur mid. Sii waxa uu u baahan yahay oo keliya:

| Oggolaanshaha | Sababta | |---|---| | org.read | Akhri xisaabaadka macaamiishaada | | sites.create | Soo saar bog | | sites.view | Akhri adeeg | | sites.delete | Jooji | | reseller.view | Liis garee adeegyadaada oo akhri isticmaalka | | reseller.provision | Hakad geli, sii daay, oo macmiil geli |

⛔ Ha siin is-dhexgalka reseller.manage. Oggolaanshahaasi wuxuu wax ka beddelaa liiskaaga qiimaha iyo aqoonsiyadaada albaabka lacag-bixinta. reseller.provision wuxuu u jiraa si sax ah si furaha aad ku dhejiso guddiga biilasha ama mareegaha uusan ugu baahnayn.

Furaha waxaa la tusaa hal mar. Ku kaydi meesha aad ku kaydiso aqoonsiyadaada kale — weligoodna ha ku jirin fayl ay u adeegto adeegahaaga webka.

2. Samee wicitaankaaga ugu horreeya

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

Taasi waxay soo celisaa adeeg kasta oo aad soo saartay, hal saf oo bogkiiba ah, oo ay la socoto macmiilka uu ka tirsan yahay, xaaladdiisa, iyo waxa aad ka qaadato. Xisaab cusub waa liis madhan — taas oo ah jawaabta saxda ah, ee ma aha khalad.

3. Is-dhexgalka oo dhan, lix wicitaan

MARKII LA JOOGO     WICITAAN
dalab la bixiyo     POST   /v1/orgs                                   hal mar macaamiil kasta
                    POST   /v1/sites                                  hal mar adeeg kasta
aysan bixinayn      POST   /v1/reseller/services/{siteId}/suspend
way bixinayaan      POST   /v1/reseller/services/{siteId}/unsuspend
way joojiyaan       DELETE /v1/sites/{siteId}
"gal hosting-ka"    POST   /v1/reseller/services/{siteId}/sso

Bixinta adeeggu waa laba wicitaan, furayaashuna waa muhiim:

# 1. xisaabta macmiilka — waxaa lagu saleeyay aqoonsiga macaamiishaada
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. boggooda — waxaa lagu saleeyay aqoonsiga adeeggaaga
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"}'

Labada sharci ee lacag ku kacaya marka aad si khaldan u fahanto

1. Xisaabta ku salee MACMIILKAaga, boggana ku salee ADEEGGAAGA. Dalabka labaad ee macmiilku waa inuu ku dhacaa xisaabta uu horey u lahaa. Labadaba ku salee adeegga oo hal macmiil wuxuu ku dambaynayaa saddex xisaab oo aan is lahayn iyo saddex gundi oo kala duwan.
2. Dir Idempotency-Key POST kasta, oo laga dhisay aqoonsigaaga shayga. Nidaam kasta oo biilasha ah wuxuu dib u tijaabiyaa — jawaab-celinta albaabka ayaa timaada laba jeer, maamuluhu wuxuu dib u maamulaa bixinta fashilantay, macmiilku wuxuu laba jeer gujiyaa. Furaha la'aanteed isku dayga labaad wuxuu abuuraa bog labaad waxaana lagugu biilinayaa taas.

Saddex jawaab oo aadan u rogi karin laba

• unsuspend wuxuu soo celin karaa 409. Taasi waxay ka dhigan tahay in kooxdayada xad-gudubka ay haysato bogga, ee ma aha adiga. Tus fariinta; ha dib u tijaabin.
• **Joojintu waxay qorshaysaa tirtirid, ma fuliso mid.** Taariikhdu waxay soo noqotaa sida pending_deletion_at. In macmiil loo sheego in xogtooda ay horey u tagtay iyadoon la joogin waa ka daran inaan waxba loo sheegin.
• disk_used_bytes waxay noqon kartaa null, null-na ma aha eber. Waxay ka dhigan tahay in aynaan cabbiri karin, ee ma aha in aan waxba la isticmaalin. Ka bood — ha ku qorin 0 diiwaannadaada, ama waxaad macmiil tusi doontaa bar isticmaal cagaaran oo loogu talagalay bog aanad wax akhris ah ka haysanin.

4. Geli macmiil

POST /v1/reseller/services/{siteId}/sso waxay soo celisaa URL hal mar la isticmaali karo oo ku tuura macmiilkaaga si toos ah xisaabtooda, oo horay loo soo galay.

⛔ Soo saar marka ay gujiyaan, weligaa ha soo saarin marka aad soo bandhigayso bogga. Xiriiriyuhu waa hal mar la isticmaali karo wuxuuna dhacaa daqiiqado gudahood, markaa xiriiriye lagu qoray bogga waxaa la gubayaa aragtida ugu horreysa ee bogga waxaana lagu dhex reebayaa kayd kasta oo u dhexeeya adiga iyo biraawsarka.

5. Ku rakib qayb halkii ay ka noqon lahayd

• WHMCS — koobiyeey qaybta ilaa modules/servers/zinn/, ku dar server kaas oo Password-kiisu yahay furahaaga API, oo deji khadka alaabta ee alaabta. Guji Test Connection: waxay samaysaa wicitaan dhab ah waxayna kuu sheegtaa waxa uu madalku yidhi.
• HostBill — koobiyeey ilaa includes/modules/Hosting/zinn/ oo ku xidh hab la mid ah.
• WordPress — Zinn® Reseller Toolkit: raadinta domainka, xiriirka gelitaanka ee ku jira hosting-ka macaamiishaada, iyo bixinta WooCommerce marka dalab la bixiyo. Isha furan ee <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ama kala soo deg Plugins guddigaaga maamulka.

6. Sii wad nolosha (Go live)

Hubi kuwan inta aadan qaadan dalab dhab ah:

• Imtixaanka xiriirku wuxuu ka gudbaa qaybta, ama curl-kaaga ugu horreeya wuxuu soo celiyaa liis.
• Liiskaaga qiimaha waa la dejiyay (Dib-u-iibinta → Qiimayaashaada).
• Albaabkaaga lacag-bixinta waa la xiray (Dib-u-iibinta → Albaabbada lacag-bixinta) — macaamiishaadu waxay ku siiyaan lacag, xisaabtaada oo ay marto.
• Faahfaahinta shirkaddaadu waa ku jirtaa (Dib-u-iibinta → Shirkaddaada) si biilasha macaamiishaadu u wataan hay'addaada sharciga ah iyo lambarka VAT, ee ma aha keenayaga.
• Waxaad meel marisay hal dalab oo dhab ah ilaa dhamaadka oo aad daawatay bogga oo soo muuqday.

Meesha ay wax walba oo kale ka yihiin

Tixraaca API-ga oo buuxa — dhammaan barta dhammaadka, laga soo saaray tilmaamayaga, oo ay la socoto oggolaanshaha mid walba u baahan yahay — wuxuu ku yaal <https://zinndigital.com/developers/api>.