Shitja e strehimit Zinn® nga sistemet tuaja

Këto terma janë të mbrojtura: riprodhoni secilin prej tyre në daljen tuaj saktësisht siç është shkruar këtu, të patërkthyer dhe të patransliteruar — WooCommerce, WordPress, Zinn, Zinn®.

Ju rishisni hostimin tonë. Klientët tuaj janë tuajt: çmimet tuaja, faturat tuaja, ofruesi juaj i pagesave. Kështu ju e drejtoni platformën tonë nga çdo gjë që tashmë përdorni — një panel faturimi, faqja juaj e WordPress, ose një skript.

Çfarë shohin realisht klientët tuaj

Para mekanikës: klientët tuaj nuk duhet të na shohin kurrë. Tre sipërfaqe dhe ju zgjidhni se cilën përdorni.

| Sipërfaqe | E kujt është | |---|---| | Paneli i hostimit, në emrin tuaj të hostit | Vendosni një emër hosti për panelin te Rishitja → Marka juaj dhe klientët tuaj hyjnë te panel.yourcompany.com me logon dhe ngjyrat tuaja. I njëjti panel, adresa juaj. | | Faqja juaj e internetit | Shtojca e WordPress vendos kërkimin e domenit dhe një lidhje hyrjeje me një klikim në faqen tuaj, dhe e merr porosinë përmes arkës tuaj të WooCommerce. | | Paneli juaj i faturimit | WHMCS ose HostBill mbetet dera e përparme; moduli kryen sigurimin pas tij dhe butoni i zonës së klientit i fut ata direkt në hostimin e lor. |

⛔ Çfarëdo që të zgjidhni, ju o tregtari i regjistruar për klientët tuaj: çmimet tuaja, faturat tuaja, numri juaj i TVSH-së, ofruesi juaj i pagesave. Ne ju faturojmë juve, një herë në muaj, me çmim shumice.

Pasi të keni vendosur një emër hosti për panelin, vendoseni atë në fushën Adresa e panelit të shtojcës së WordPress dhe në asgjë tjetër — lidhjet e hyrjes që ky API gjeneron e ndjekin atë automatikisht.

Katër mënyrat e hyrjes

Ka katër mënyra hyrjeje dhe të gjitha bëjnë të njëjtën gjë në prapaskenë:

| | Për | |---|---| | Moduli WHMCS | Një dyqan WHMCS | | Moduli HostBill | Një dyqan HostBill | | Shtojca e WordPress | Shitjen nga faqja juaj e WordPress ose WooCommerce | | API-ja | Çdo gjë tjetër — Blesta, një sistem i brendshëm, një skript cron |

1. Merrni një çelës API

Në panelin tuaj të kontrollit, shkoni te Çelësat API dhe krijoni një. Jepini vetëm atë që i nevojitet:

| Leja | Pse | |---|---| | org.read | Lexoni llogaritë e klientëve tuaj | | sites.create | Siguroni një faqe | | sites.view | Lexoni një shërbim | | sites.delete | Mbyllni | | reseller.view | Listoni shërbimet tuaja dhe lexoni përdorimin | | reseller.provision | Pezulloni, lëshoni dhe futni një klient brenda |

⛔ Mos i jepni një integrimi lejen reseller.manage. Kjo leje ndryshon listën tuaj të çmimeve dhe kredencialet e portës suaj të pagesave. reseller.provision ekziston pikërisht që një çelës që ngjitni në një panel faturimi ose në një faqe interneti të mos e ketë atë.

Çelësi shfaqet vetëm një herë. Ruajeni atë aty ku ruani kredencialet tuaja të tjera — kurrë në një skript që shërbehet nga serveri juaj i uebit.

2. Bëni thirrjen tuaj të parë

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

Kjo kthen çdo shërbim që keni siguruar, një rresht për faqe, me klientin të cilit i përket, statusin e tij dhe çfarë paguani për të. Në një llogari të re është një listë boshe — e cila është përgjigjja e saktë, jo një gabim.

3. I gjithë integrimi, në gjashtë thirrje

KUR                  THIRRJA
një porosi paguhet   POST   /v1/orgs                                   një herë për KLIENT
                     POST   /v1/sites                                  një herë për SHËRBIM
ata nuk kanë paguar  POST   /v1/reseller/services/{siteId}/suspend
ata paguajnë         POST   /v1/reseller/services/{siteId}/unsuspend
ata anullojnë        DELETE /v1/sites/{siteId}
"hyr në hostim"      POST   /v1/reseller/services/{siteId}/sso

Sigurimi përbëhet nga dy thirrje dhe çelësat kanë rëndësi:

# 1. llogaria e klientit — e lidhur me ID-në TUAJ të klientit
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. faqja e tyre — e lidhur me ID-në TUAJ të shërbimit
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"}'

Dy rregulla që kushtojnë para kur i kuptoni gabim

Lidhni llogarinë me KLIENTIN tuaj dhe faqen me SHËRBIMIN tuaj. Porosia e dytë e një klienti

duhet të përfundojë në llogarinë që ai tashmë ka. Lidhini të dyja me shërbimin dhe një klient përfundon me tre llogari të palidhura dhe tre panele të veçanta.

Dërgoni një Idempotency-Key në çdo POST, të ndërtuar nga ID-ja juaj për atë gjë. Çdo

sistem faturimi riprovon — një thirrje nga porta mbërrin dy herë, një administrator ri-ekzekuton një sigurim të dështuar, një klient klikon dy herë. Pa çelësin, përpjekja e dytë krijon një faqe të dytë dhe ju faturioheni për të.

Tri përgjigje që nuk duhet t'i thjeshtoni në dy

unsuspend mund të kthejë 409. Kjo do të thotë se ekipi ynë i abuzimit po e mban faqen, jo ju.

Shfaqni mesazhin; mos e provoni përsëri.

**Mbyllja planifikon një fshirje, nuk e kryen atë.** Data kthehet si pending_deletion_at. T'i thuash

një klienti se të dhënat e tij janë zhdukur tashmë kur nuk janë, është më keq sesa të mos i thuash asgjë.

disk_used_bytes mund të jetë null, dhe null nuk është zero. Do të thotë se nuk mundëm të

matnim, jo se nuk u përdor asgjë. Anashkalojeni — mos shkruani 0 në të dhënat tuaja, ose do t'i shfaqni një klienti një shirit përdorimi të gjelbër për një faqe për të cilën nuk keni asnjë lexim.

4. Futni një klient brenda

POST /v1/reseller/services/{siteId}/sso kthen një URL me një përdorim të vetëm që e fut klientin tuaj direkt në llogarinë e tij, tashmë të kyçur.

⛔ Gjenerojeni atë kur ata klikojnë, kurrë kur shfaqni faqen. Lidhja është me një përdorim të vetëm dhe skadon brenda pak minutash, kështu që një lidhje e shkruar në një faqe digjet në shikimin e parë të faqes dhe mbetet në çdo cache midis jush dhe shfletuesit.

5. Instaloni më mirë një modul

WHMCS — kopjoni modulin te modules/servers/zinn/, shtoni një server fjalëkalimi i të cilit

(Password) është çelësi juaj API dhe vendosni linjën e produktit te produkti. Shtypni Test Connection: bën një thirrje të vërtetë dhe ju tregon se çfarë tha platforma.

HostBill — kopjoni te includes/modules/Hosting/zinn/ dhe lidheni në të njëjtën mënyrë.
WordPress — Zinn® Reseller Toolkit: kërkimi i domenit, një lidhje hyrjeje në hostimin e klientëve

tuaj dhe sigurimi i WooCommerce kur një porosi paguhet. Me burim të hapur te <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ose shkarkojeni nga Plugins në panelin tuaj të kontrollit.

6. Kaloni direkt

Kontrolloni këto para se të merrni një porosi të vërtetë:

Testi i lidhjes kalon në modul, ose curl-i juaj i parë kthen një listë.
Lista juaj e çmimeve është caktuar (Rishitja → Çmimet tuaja).
Porta juaj e pagesave është e lidhur (Rishitja → Portat e pagesave) — klientët tuaj ju paguajnë juve,

përmes llogarisë suaj.

Detajet e kompanisë suaj janë vendosur (Rishitja → Kompania juaj) kështu që faturat e klientëve tuaj mbajnë

subjektin tuaj ligjor dhe numrin e TVSH-së, jo tonin.

Keni bërë një porosi të vërtetë nga fillimi në fund dhe keni parë faqen të shfaqet.

Ku ndodhet çdo gjë tjetër

Referenca e plotë e API-së — çdo pikë përfundimtare (endpoint), e gjeneruar nga specifikimi ynë, me lejën që i nevojitet secilës — gjendet te <https://zinndigital.com/developers/api>.