yoÈdè
Bẹrẹ lọ́fẹ́
WọléBẹrẹ lọ́fẹ́

Ilé ìmọ̀

Titaja aleebu Zinn® lati lori awọn eto rẹ yii

Lo gbàlà hosting Zinn láti inú billing panel rẹ, ojú-wẹ́bù WordPress tabi awọn aṣàlẹgbẹ: gba API key kan, ṣe ìpè àkọ́kọ́ rẹ, ati awọn ìpè mẹ́fà ti gbogbo integration naa fi ṣe.

O oṣu kan o n ta iṣẹ-itẹgbẹ wa. Awọn onibara rẹ jẹ tirẹ: awọn idiyele rẹ, awọn iwe-owo rẹ, olupese isanwo rẹ. Eyi ni bi o ṣe n ṣiṣẹ pẹpẹ wa lati ohunkohun ti o ti nṣiṣẹ tẹlẹ — igbimọ isanwo, aaye WordPress tirẹ, tabi iwe afọwọkọ kan.

Ohun ti awọn onibara rẹ ri ni otitọ

Ṣaaju awọn imọ-ẹrọ: awọn onibara rẹ ko ni lati ri wa ri. Awọn oju mẹta, ati pe o yan eyi ti o lo.

| Oju | Ti ta ni | |---|---| | Igbimọ iṣẹ-itẹgbẹ, lori orukọ agbalejo tirẹ | Ṣeto orukọ agbalejo igbimọ kan labẹ Reselling → Your brand ati awọn onibara rẹ wọle ni panel.yourcompany.com pẹlu aami rẹ ati awọn awọ rẹ. Igbimọ kanna, adirẹsi rẹ. | | Oju opo wẹẹbu tirẹ | Pilogi WordPress fi wiwa agbegbe ati ọna asopọ iwọle-tẹ-kan sori aaye rẹ, o si gba aṣẹ naa nipasẹ isanwo WooCommerce tirẹ. | | Igbimọ isanwo rẹ | WHMCS tabi HostBill Duro bi ilẹkun iwaju; modulu naa pese lẹhin rẹ ati bọtini agbegbe-onibara wọ wọn taara sinu iṣẹ-itẹgbẹ wọn. |

⛔ Eyikeyi ti o ba yan, o ni oṣiṣẹ akọkọ ti o ni akọsilẹ fun awọn onibara rẹ: awọn idiyele rẹ, awọn iwe-owo rẹ, nọmba VAT rẹ, olupese isanwo rẹ. A gba lọwọ rẹ, lẹẹkan ni oṣu kan, ni osunwon.

Ni kete ti o ba ti ṣeto orukọ agbalejo igbimọ kan, fi sii sinu aaye Panel address ti pilogi WordPress ati ninu ohunkohun miiran — awọn ọna asopọ iwọle ti API yii nṣẹda tẹle e laifọwọyi.

Awọn ọna mẹrin lati wọle

Awọn ọna mẹrin lo wa lati wọle, ati pe gbogbo wọn n ṣe ohun kan náà ni abẹlẹ:

| | Fun | |---|---| | Modulu WHMCS | Ile-itaja WHMCS kan | | Modulu HostBill | Ile-itaja HostBill kan | | Pilogi WordPress | Tita lati oju opo wẹẹbu WordPress tabi WooCommerce tirẹ | | API | Ohunkohun miiran — Blesta, eto inu ile, iwe afọwọkọ cron kan |

1. Gba bọtini API kan

Ninu dasibodu rẹ, lọ si API keys ki o ṣẹda ọkan. Fun ni ohun ti o nilo nikan:

| Igbanilaaye | Idi | |---|---| | org.read | Ka awọn akọọlẹ onibara rẹ | | sites.create | Pese aaye kan | | sites.view | Ka iṣẹ kan | | sites.delete | Fopin si | | reseller.view | Ṣe atọju awọn iṣẹ rẹ ki o ka lilo | | reseller.provision | Daduro, tu silẹ, ki o wọ onibara kan wọle |

⛔ Maṣe fun iṣọpọ reseller.manage. Igbanilaaye yẹn ṣatunkọ atọka idiyele rẹ ati awọn iwe-ẹri ẹnu-ọna isanwo tirẹ. reseller.provision wa ni deede ki bọtini ti o lẹ mọ igbimọ isanwo tabi oju opo wẹẹbu ko nilo rẹ.

A nfi bọtini han lẹẹkan. Tọju rẹ nibi ti o ti n tọju awọn iwe-ẹri miiran rẹ — maṣe jẹ ninu faili kan ti olupin wẹẹbu rẹ n ṣiṣẹ.

2. Ṣe ipe akọkọ rẹ

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

Iyẹn da gbogbo iṣẹ ti o ti pese pada, apa kan fun aaye kọọkan, pẹlu onibara ti o jẹ ti rẹ, ipo rẹ, ati ohun ti o gba owo fun. Lori akọkọ tuntun o jẹ atọka ti o ṣofo — eyiti o jẹ idahun ti o tọ, kii ṣe aṣiṣe.

3. Gbogbo iṣọpọ naa, ni awọn ipe mẹfa

NIGBÀ TI            IPE
aṣẹ kan ti san      POST   /v1/orgs                                   lẹẹkan fun ONIBARA
                     POST   /v1/sites                                  lẹẹkan fun IṢẸ
Wọn ko ti san owo   POST   /v1/reseller/services/{siteId}/suspend
Wọn san owo         POST   /v1/reseller/services/{siteId}/unsuspend
Wọn fagile          DELETE /v1/sites/{siteId}
"wọle si iṣẹ-itẹgbẹ" POST   /v1/reseller/services/{siteId}/sso

Ipese jẹ awọn ipe meji, ati awọn bọtini ṣe pataki:

# 1. akọkọ onibara naa — ti a ṣeto lori id onibara RẸ
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. aaye wọn — ti a ṣeto lori id iṣẹ RẸ
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"}'

Awọn ofin meji ti o n gbowo nigbati o ba gba wọn aṣiṣe

  1. Ṣeto akọkọ lori ONIBARA rẹ ati aaye lori IṢẸ rẹ. Aṣẹ keji onibara kan gbọdọ de sinu akọkọ ti wọn ti ni tẹlẹ. Ṣeto mejeeji lori iṣẹ naa ati onibara kan pari pẹlu awọn akọkọ mẹta ti ko ni ibatan ati awọn igbimọ mẹta ti o yatọ.
  2. Firanṣẹ Idempotency-Key lori gbogbo POST, ti a kọ lati id tirẹ fun ohun naa. Gbogbo eto isanwo n tun gbiyanju — ipe apapọ ẹnu-ọna de lẹmeji, alakoso tun ṣiṣẹ ipese ti o kuna, onibara tẹ lẹmeji. Laisi bọtini naa igbiyanju keji ṣẹda aaye keji ati pe a gba owo rẹ fun ọ.

Awọn idahun mẹta ti o ko gbọdọ sọ di alapin si meji

  • unsuspend le dahun 409. Iyẹn tumọ si pe ẹgbẹ iwa-ibajẹ wa n mu aaye naa, kii ṣe iwọ. Fihan ifiranṣẹ naa; maṣe tun gbiyanju rẹ.
  • **Fopin si ṣeto ipagbeegbẹ kan, kii ṣe ṣe ọkan.** Ọjọ naa pada wa bi pending_deletion_at. Sísọ fun onibara pe data wọn ti lọ tẹlẹ nigbati ko lọ jẹ buru ju sísọ fun wọn ni nkan kan.
  • disk_used_bytes le jẹ null, ati null kii ṣe odo. O tumọ si pe a ko le wọn, kii ṣe pe ko si nkan ti a lo. Foju rẹ silẹ — maṣe kọ 0 sinu awọn akọọlẹ tirẹ, tabi iwọ yoo fihan onibara igba lilo alawọ ewe fun aaye kan ti o ko ni kika lati.

4. Wọ onibara kan wọle

POST /v1/reseller/services/{siteId}/sso da URL lilo-ẹyọkan pada ti o sọ onibara rẹ kalẹ taara sinu akọkọ tiwọn, ti a ti wọle tẹlẹ.

⛔ Ṣẹda rẹ nigbati wọn ba tẹ, maṣe ṣe nigbati o ba n ṣe oju-iwe naa. Ọna asopọ naa jẹ lilo-ẹyọkan o si pari laarin awọn iṣẹju, nitorinaa ọna asopọ ti a kọ sinu oju-iwe kan ni a sun lori wiwo oju-iwe akọkọ ati fi silẹ ni gbogbo cache laarin iwọ ati aṣàwákiri naa.

5. Fi modulu kan sori ẹrọ dipo

  • WHMCS — da modulu naa si modules/servers/zinn/, fi olupin kan kun eyiti Password rẹ jẹ bọtini API rẹ, ki o ṣeto ila ọja lori ọja naa. Tẹ Test Connection: o ṣe ipe gidi kan o si sọ fun ọ ohun ti pẹpẹ sọ.
  • HostBill — da si includes/modules/Hosting/zinn/ ki o so o pọ ni ọna kanna.
  • WordPress — Zinn® Reseller Toolkit: wiwa agbegbe, ọna asopọ iwọle sinu iṣẹ-itẹgbẹ awọn onibara rẹ, ati ipese WooCommerce nigbati a ba san aṣẹ kan. Orisun ṣiṣi ni <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, tabi gba a silẹ lati Plugins ninu dasibodu rẹ.

6. Lọ laaye

Ṣayẹwo iwọnyi ṣaaju ki o to gba aṣẹ gidi kan:

  • Idanwo asopọ kọja lori modulu naa, tabi curl akọkọ rẹ da atọka pada.
  • Atọka idiyele rẹ ti ṣeto (Reselling → Your prices).
  • Ẹnu-ọna isanwo rẹ ti sopọ (Reselling → Payment gateways) — awọn onibara rẹ san owo fun ọ, nipasẹ akọkọ tirẹ.
  • Awọn alaye ile-iṣẹ rẹ wa ninu (Reselling → Your company) nitorinaa awọn iwe-owo onibara rẹ gbe nkan ti o tọ aṣofin rẹ ati nọmba VAT, kii ṣe tiwa.
  • O ti gbe aṣẹ gidi kan lati opin de opin o si wo aaye naa han.

Nibi ti ohun gbogbo miiran wa

Itọkasi API pipe — gbogbo ipari, ti a ṣẹda lati sipesifikesonu wa, pẹlu igbanilaaye ti kọọkan nilo — wa ni <https://zinndigital.com/developers/api>.

Ṣe o tun di mọ?

Ìtìlẹ́yìn wà lórí gbogbo ètò, a sì ń dáhùn ní èdè rẹ.

Kan si àtìlẹyìn → Gbogbo àpilẹ̀kọ →

A n lo àwọn kuki itupalẹ lati loye bi a ṣe n lo aaye naa. A n gbe wọn sori ẹrọ rẹ nikan ti o ba gba. Ilana kuki

Titaja aleebu Zinn® lati lori awọn eto rẹ yii