Ka iibinta martigelinta Zinn® nidaamyadaada

Waxaad dib u sii iibinaysaa martigelintayada (hosting). Macaamiishaadu adigaa iska leh: qiimayaashaada, qaansheegyadaada, bixiyahaaga lacag-bixinta. Tani waa sida aad barnaamijkeena uga maamulayso wax kasta oo aad horey u isticmaalaysay — guddiga biilasha, bartaada gaarka ah ee WordPress, ama qoraal koodh ah (script).

Waxa ay macaamiishaadu dhab ahaan arkaan

Kahor farsamada: macaamiishaadu marnaba maahan inay na arkaan. Saddex qaab, adiguna waxaad doorataa midka aad isticmaalayso.

⛔ Mid kastoo aad doorato, adigaa u ah ganacsadaha diiwaangashan macaamiishaada: qiimayaashaada, qaansheegyadaada, lambarkaaga VAT, bixiyahaaga lacag-bixinta. Annagu adiga ayaan biil kuu soo dirnaa, bishii hal mar, qiimo jumlada ah.

Markaad dejiso magac-martigeliyaha guddiga, geli goobta Panel address ee furaha WordPress oo ha gelin meel kale toona — xiriiriyeyaasha gelitaanka ee API-gani sameeyo waxay u raacayaan si toos ah.

Afarta hab ee loo galo

Waxaa jira afar hab oo loo galo, dhammaantoodna waxay hoosta ka qabtaan isla hal shay:

1. Hel fure API

Gudaha dashboard-kaaga, tag API keys oo samee mid cusub. Sii kaliya waxa uu u baahan yahay:

⛔ Ha siinin is-dhexgalka (integration) reseller.manage. Idankaasi wuxuu wax ka beddelaa liiskaaga qiimaha iyo xogtaada sirta ah ee marinka lacag-bixinta. reseller.provision waxay u jirtaa si sax ah si fure aad ku dhejisay guddi biilasha ama websaydh uusan ugu baahan isaga.

Furaha waxaa la muujiyaa hal mar oo kaliya. Ku keydi meesha aad ku keydiso xogtaada kale ee sirta ah — marnaba ha ku keydin fayl uu bixiyo seerfarkaaga shabakadu.

2. Samee wicitaankaagii ugu horreeyay

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

Taasi waxay soo celinaysaa adeeg kasta oo aad diyaarisay, hal saf goobtiiba, oo ay la socdaan macmiilka uu leeyahay, xaaladdiisa, iyo waxa aad ku dallacdo. Koonto cusub waxay ku soo noqonaysaa liis madhan — taas oo ah jawaabta saxda ah, ee aan ahayn qalad.

3. Dhammaan is-dhexgalka, oo ku jira lix wicitaan

GOORTA               WAC
dalab la bixiyo      POST   /v1/orgs                                   hal mar MACMIILKIBA
                     POST   /v1/sites                                  hal mar ADEEGGIBA
aysan bixin          POST   /v1/reseller/services/{siteId}/suspend
ay bixiyaan          POST   /v1/reseller/services/{siteId}/unsuspend
ay joojiyaan         DELETE /v1/sites/{siteId}
"gal martigelinta"   POST   /v1/reseller/services/{siteId}/sso

Diyaarintu waa laba wicitaan, furayaashuna muhiimad ayay leeyihiin:

# 1. koontada macmiilka — oo ku saleysan aqoonsigaaga (id) MACMIILKA
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. goobtooda — oo ku saleysan aqoonsigaaga (id) ADEEGGA
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"}'

Laba xeer oo lacag kugu kici doona haddii aad qaladdo

1. Koontada ku saley MACMIILKAAGA goobtana ku saley ADEEGGAAGA. Dalabka labaad ee macmiilka waa inuu ku dhacaa koontada uu horey u lahaa. Haddii aad labadaba ku saleyso adeegga hal macmiil wuxuu ku dambaynayaa saddex koonto oo aan xiriir lahayn iyo saddex guddi oo kala duwan.
2. U dir Idempotency-Key POST kasta, oo laga dhisay aqoonsigaaga gaarka ah ee shayga. Nidaam kasta oo biilal dib ayuu isku dayaa — wicitaan dib-u-celin ee marin lacag-bixineed ayaa laba jeer yimaada, maamule ayaa dib u kiciya diyaarin guul-darreysatay, macmiil ayaa laba jeer gujiya. Furaha la'aantiis isku-dayga labaad wuxuu abuurayaa goob labaad waana lagugu dallacayaa.

Saddex jawaabood oo aadan u rogin laba

• unsuspend waxay ku jawaabi kartaa 409. Taas macnaheedu waa kooxdayada xadgudubyada ayaa haysa goobta, ee ma tihid adiga. Muuji fariinta; dib ha isugu dayin.
• **Joojintu waxay qorsheysaa tirtirid, ma fuliso mid.** Taariikhda waxay ku soo noqotaa pending_deletion_at. Inaad u sheegto macmiil xogtiisu inay mar hore tagtay iyadoo aysan taasi jirin ayaa ka daran inaad waxba u sheegi weydo.
• disk_used_bytes waxay noqon kartaa null, null-na maaha eber. Waxay ka dhigan tahay inaanan cabbiri karin, ee maaha inaan waxba la isticmaalin. Ka bood — ha ku qorin 0 diiwaannadaada, haddii kale waxaad macmiilka tusinaysaa xariiq cagaaran oo isticmaalka goob aadan wax akhris ah ka haynin.

4. Geli macmiil

POST /v1/reseller/services/{siteId}/sso waxay soo celisaa URL hal mar la isticmaalo oo macmiilkaaga si toos ah u geynaya koontadiisa gaarka ah, isagoo mar hore galay.

⛔ Samee marka ay gujiyaan, marnaba ha sameynin marka aad bogga soo bandhigeyso. Xiriiriyuhu waa hal mar la isticmaal wuxuuna dhacayaa daqiiqado gudahood, markaa xiriiriye lagu qoray bog waxaa lagu gubaa booqashada ugu horreysa ee bogga waxaana lagaga tagaa kayd (cache) kasta oo u dhexeeya adiga iyo biraawsarka.

5. Taas beddelkeeda rakib modhool

• WHMCS — ku koobiyeey modhoolka modules/servers/zinn/, ku dar seerfar Password-kiisu yahay furahaaga API, oo deji nooca alaabta (product line) ee alaabta. Riix Test Connection: wuxuu sameynayaa wicitaan dhab ah wuxuuna kuu sheegayaa waxa barnaamijku sheegay.
• HostBill — ku koobiyeey includes/modules/Hosting/zinn/ kuna xir isla habkaas.
• WordPress — Zinn® Reseller Toolkit: baadigoobka magac-domain, xiriiriye gelitaan oo loo galo martigelinta macaamiishaada, iyo u diyaarinta WooCommerce marka dalab la bixiyo. Xigasho furan (open source) ka eeg <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ama ka soo dejiso qaybta Plugins ee dashboard-kaaga.

6. Toos u howlgeli

Hubi kuwan kahor inta aadan qaadin dalab dhab ah:

• Tijaabada xiriirku waxay ku guuleysatay modhoolka, ama curl-kaagii ugu horreeyay wuxuu soo celiyay liis.
• Liiskaaga qiimaha waa la dejiyay (Reselling → Your prices).
• Marinkaaga lacag-bixinta waa la xiray (Reselling → Payment gateways) — macaamiishaadu adiga ayay ku siinayaan lacagta, iyagoo u maraya koontadaada gaarka ah.
• Faahfaahinta shirkaddaada waa la geliyay (Reselling → Your company) si qaansheegyada macaamiishaadu u qaataan magaca hay'addaada sharci iyo lambarka VAT, ee aysan u qaadan kuweenna.
• Waxaad meel marisay hal dalab oo dhab ah min bilow ilaa dhammaad waxaadna aragtay goobta oo soo muuqatay.

Halkee wax kasta oo kale ku yaallaan

Tixraaca buuxa ee API-ga — bar-dhamaad kasta, oo laga soo saaray qeexitaankayaga, oo leh idanka mid kastaa u baahan yahay — wuxuu ku yaallaa <https://zinndigital.com/developers/api>.