Kuuza hosting ya Zinn® kutoka kwenye mifumo yako mwenyewe

Unauza mwenyeji wetu wa wavuti. Wateja wako ni wako: bei zako, ankara zako, mtoa huduma wako wa malipo. Hivyo ndivyo unavyoendesha jukwaa letu kutoka kwa chochote ambacho tayari unakiendesha — paneli ya utozaji, tovuti yako mwenyewe ya WordPress, au hati (script).

Kile ambacho wateja wako wanakiona hasa

Kabla ya mbinu zenyewe: wateja wako hawapaswi kutuona kamwe. Kuna sehemu tatu za kuingiliana, na unachagua unayotumia ipi.

| Sehemu | Ya nani | |---|---| | Paneli ya mwenyeji, kwenye jina lako mwenyewe la mwenyeji (hostname) | Weka jina la mwenyeji la paneli chini ya Kuuza tena → Chapa yako na wateja wako wanaingia katika panel.yourcompany.com wakiwa na nembo yako na rangi zako. Paneli ileile, anwani yako. | | Tovuti yako mwenyewe | Programu jalizi ya WordPress inaweka utafutaji wa vikoa na kiungo cha kuingia kwa mbofyo mmoja kwenye tovuti yako, na kuchukua agizo kupitia malipo yako ya WooCommerce. | | Paneli yako ya utozaji | WHMCS au HostBill inasalia kuwa mlango wa mbele; moduli inatoa huduma nyuma yake na kitufe cha eneo la mteja kinawaingiza moja kwa moja kwenye mwenyeji wao. |

⛔ Chochote unachochagua, wewe ndiye mfanyabiashara wa kumbukumbu kwa wateja wako: bei zako, ankara zako, nambari yako ya VAT, mtoa huduma wako wa malipo. Tunakutoza wewe, mara moja kwa mwezi, kwa bei ya jumla.

Mara tuakapoweka jina la mwenyeji la paneli, liweke kwenye uwanja wa Anwani ya paneli wa programu jalizi ya WordPress na sio mahali pengine popote — viungo vya kuingia ambavyo API hii inatengeneza vinafuata kiotomatiki.

Njia nne za kuingia

Kuna njia nne za kuingia, na zote hufanya kitu kile kile kwa nyuma:

| | Kwa ajili ya | |---|---| | Moduli ya WHMCS | Duka la WHMCS | | Moduli ya HostBill | Duka la HostBill | | Programu jalizi ya WordPress | Kuuza kutoka kwenye tovuti yako mwenyewe ya WordPress au WooCommerce | | API | Kitu kingine chochote — Blesta, mfumo wa ndani, hati ya cron |

1. Pata ufunguo wa API

Kwenye dashibodi yako, nenda kwenye Funguo za API na uunde moja. Ipe kile tu kinachohitajika:

| Ruhusa | Kwa nini | |---|---| | org.read | Soma akaunti za wateja wako | | sites.create | Toa tovuti | | sites.view | Soma huduma | | sites.delete | Sitisha/Futa | | reseller.view | Orodhesha huduma zako na usome matumizi | | reseller.provision | Simamisha, toa, na umuingize mteja kwenye mfumo |

⛔ Usipe ujumuishaji ruhusa ya reseller.manage. Ruhusa hiyo inahariri orodha yako ya bei na vitambulisho vyako vya lango la malipo. reseller.provision ipo hasa ili ufunguo unaoubandika kwenye paneli ya utozaji au tovuti usihitaji kuwa nao.

Ufunguo unaonyeshwa mara moja. Uhifadhi pale unapohifadhi vitambulisho vyako vingine — usiweke kamwe kwenye faili inayotumiwa na seva yako ya wavuti.

2. Fanya simu yako ya kwanza

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

Hiyo inarudisha kila huduma uliyotoa, mstari mmoja kwa kila tovuti, pamoja na mteja anayemiliki, hali yake, na unachotoza kwa ajili yake. Kwenye akaunti mpya ni orodha tupu — ambalo ndilo jibu sahihi, sio kosa.

3. Ushirikiano mzima, katika miito sita

WAKATI                 MWITO (CALL)
agizo limelipwa        POST   /v1/orgs                                   mara moja kwa WATEJA
                       POST   /v1/sites                                  mara moja kwa HUDUMA
hawajalipa             POST   /v1/reseller/services/{siteId}/suspend
wanalipa               POST   /v1/reseller/services/{siteId}/unsuspend
wanaghairi             DELETE /v1/sites/{siteId}
"ingia kwenye mwenyeji" POST   /v1/reseller/services/{siteId}/sso

Utoaji wa huduma ni miito miwili, na funguo ni muhimu:

# 1. akaunti ya mteja — imewekwa alama kwenye kitambulisho cha mteja WAKO
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. tovuti yao — imewekwa alama kwenye kitambulisho cha huduma YAKO
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"}'

Sheria mbili zinazogharimu pesa unapozikosea

Weka alama kwenye akaunti kwa MTEJA wako na tovuti kwa HUDUMA yako. Agizo la pili la mteja lazima liingie kwenye akaunti aliyo nayo tayari. Weka alama zote mbili kwenye huduma na mteja mmoja ataishia kuwa na akaunti tatu zisizohusiana na paneli tatu tofauti.
Tuma Idempotency-Key kwenye kila POST, iliyojengwa kutoka kwa kitambulisho chako mwenyewe kwa kitu hicho. Kila mfumo wa utozaji unajaribu tena — maoni ya lango yanawasili mara mbili, msimamizi anaendesha tena utoaji ulioshindwa, mteja anabofya mara mbili. Bila ufunguo huo jaribio la pili linaunda tovuti ya pili na utatozwa kwa ajili yake.

Majibu matatu ambayo lazima usiyachanganye yawe mawili

unsuspend inaweza kujibu 409. Hiyo inamaanisha timu yetu ya matumizi mabaya inashikilia tovuti, sio wewe. Onyesha ujumbe; usiiondoe kwa kujaribu tena.
**Kusitisha kunapanga kufutwa, hakufanyi mara moja.** Tarehe inarudi kama pending_deletion_at. Kumwambia mteja data zake zimetoweka wakati hazijatoweka ni kubaya kuliko kutomwambia chochote.
disk_used_bytes inaweza kuwa null, na null sio sifuri. Ina maana hatukuweza kupima, sio kwamba hakuna kilichotumiwa. Ipuuze — usiandike 0 kwenye kumbukumbu zako mwenyewe, au utamwonyesha mteja upau wa kijani wa matumizi kwa tovuti ambayo huna usomaji wowote kuihusu.

4. Mwingize mteja kwenye mfumo

POST /v1/reseller/services/{siteId}/sso inarudisha URL ya matumizi ya mara moja inayompeleka mteja wako moja kwa moja kwenye akaunti yake mwenyewe, akiwa tayari ameingia.

⛔ Itengeneze wanapobofya, usiitengeneze kamwe unapotengeneza ukurasa. Kiungo hiki kinatumika mara moja na kinakwisha muda wake ndani ya dakika chache, kwa hiyo kiungo kilichoandikwa kwenye ukurasa kinachomeka kwenye mwonekano wa kwanza wa ukurasa na kinaachwa katika kila akiba (cache) kati yako na kivinjari.

5. Sakinisha moduli badala yake

WHMCS — nakili moduli kwenye modules/servers/zinn/, ongeza seva ambayo Nenosiri lake ni ufunguo wako wa API, na uweke safu ya bidhaa kwenye bidhaa hiyo. Bonyeza Jaribu Muunganisho (Test Connection): inafanya mwito halisi na kukuambia kile jukwaa kilichosema.
HostBill — nakili kwenye includes/modules/Hosting/zinn/ na uiunganishe kwa njia ile ile.
WordPress — Zinn® Reseller Toolkit: utafutaji wa vikoa, kiungo cha kuingia kwenye mwenyeji wa wateja wako, na utoaji wa WooCommerce wakati agizo limelipwa. Chanzo huria kiko katika <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, au iipakue kutoka Programu Jalizi (Plugins) kwenye dashibodi yako.

6. Nenda moja kwa moja (Go live)

Angalia haya kabla ya kuchukua agizo halisi:

Jaribio la muunganisho limefaulu kwenye moduli, au curl yako ya kwanza inarudisha orodha.
Orodha yako ya bei imewekwa (Kuuza tena → Bei zako).
Lango lako la malipo limeunganishwa (Kuuza tena → Malango ya malipo) — wateja wako wanalipa wewe, kupitia akaunti yako mwenyewe.
Maelezo ya kampuni yako yapo ndani (Kuuza tena → Kampuni yako) ili ankara za wateja wako ziwe na huluki yako ya kisheria na nambari ya VAT, sio yetu.
Umeweka agizo moja halisi kutoka mwanzo hadi mwisho na ukaona tovuti ikitokea.

Mahali ambapo kila kitu kingine kipo

Rejeleo kamili la API — kila eneo la mwisho (endpoint), lililotolewa kutoka kwa maelezo yetu, na ruhusa ambayo kila moja inahitaji — liko katika <https://zinndigital.com/developers/api>.