നിങ്ങളുടെ സ്വന്തം സിസ്റ്റങ്ങളിൽ നിന്ന് Zinn® ഹോസ്റ്റിംഗ് വിൽക്കുന്നു

നിങ്ങൾ ഞങ്ങളുടെ ഹോസ്റ്റിംഗ് റീസെൽ ചെയ്യുന്നു. നിങ്ങളുടെ ക്ലയന്റുകൾ നിങ്ങളുടേതാണ്: നിങ്ങളുടെ വിലകൾ, നിങ്ങളുടെ ഇൻവോയ്സുകൾ, നിങ്ങളുടെ പേയ്‌മെന്റ് ദാതാവ്. നിങ്ങൾ ഇതിനകം പ്രവർത്തിപ്പിക്കുന്ന ഏതിൽ നിന്നും — ഒരു ബില്ലിംഗ് പാനൽ, നിങ്ങളുടെ സ്വന്തം WordPress സൈറ്റ്, അല്ലെങ്കിൽ ഒരു സ്ക്രിപ്റ്റ് — നിങ്ങൾ എങ്ങനെയാണ് ഞങ്ങളുടെ പ്ലാറ്റ്‌ഫോം പ്രവർത്തിപ്പിക്കുന്നത് ഇതാ.

നിങ്ങളുടെ ക്ലയന്റുകൾ യഥാർത്ഥത്തിൽ എന്താണ് കാണുന്നത്

സാങ്കേതിക വശങ്ങൾക്ക് മുമ്പ്: നിങ്ങളുടെ ക്ലയന്റുകൾ ഒരിക്കലും ഞങ്ങളെ കാണേണ്ടതില്ല. മൂന്ന് പ്രതലങ്ങൾ, അവയിൽ ഏതാണ് നിങ്ങൾ ഉപയോഗിക്കേണ്ടതെന്ന് നിങ്ങൾക്ക് തിരഞ്ഞെടുക്കാം.

| പ്രതലം | ആരുടെതാണ് | |---|---| | ഹോസ്റ്റിംഗ് പാനൽ, നിങ്ങളുടെ സ്വന്തം ഹോസ്റ്റ്നാമത്തിൽ | Reselling → Your brand എന്നതിന് കീഴിൽ ഒരു പാനൽ ഹോസ്റ്റ്നാമം സജ്ജീകരിക്കുക, നിങ്ങളുടെ ക്ലയന്റുകൾ panel.yourcompany.com എന്നതിൽ നിങ്ങളുടെ ലോഗോയും നിറങ്ങളും ഉപയോഗിച്ച് സൈൻ ഇൻ ചെയ്യുക. ഒരേ പാനൽ, നിങ്ങളുടെ വിലാസം. | | നിങ്ങളുടെ സ്വന്തം വെബ്സൈറ്റ് | WordPress പ്ലഗിൻ നിങ്ങളുടെ സൈറ്റിൽ ഡൊമെയ്ൻ തിരയലും ഒറ്റ ക്ലിക്കിലുള്ള സൈൻ-ഇൻ ലിങ്കും നൽകുകയും നിങ്ങളുടെ സ്വന്തം WooCommerce ചെക്ക്‌ഔട്ട് വഴി ഓർഡർ സ്വീകരിക്കുകയും ചെയ്യുന്നു. | | നിങ്ങളുടെ ബില്ലിംഗ് പാനൽ | WHMCS അല്ലെങ്കിൽ HostBill മുൻവാതിലായി തുടരുന്നു; അതിനു പിന്നിൽ മൊഡ്യൂൾ പ്രൊവിഷൻ ചെയ്യുകയും ക്ലയന്റ് ഏരിയ ബട്ടൺ അവരെ നേരെ അവരുടെ ഹോസ്റ്റിംഗിലേക്ക് സൈൻ ഇൻ ചെയ്യിക്കുകയും ചെയ്യുന്നു. |

⛔ നിങ്ങൾ ഏത് തിരഞ്ഞെടുത്താലും, നിങ്ങളുടെ ക്ലയന്റുകളുടെ മെർച്ചന്റ് ഓഫ് റെക്കോർഡ് നിങ്ങളാണ്: നിങ്ങളുടെ വിലകൾ, നിങ്ങളുടെ ഇൻവോയ്സുകൾ, നിങ്ങളുടെ VAT നമ്പർ, നിങ്ങളുടെ പേയ്‌മെന്റ് ദാതാവ്. ഞങ്ങൾ നിങ്ങളിൽ നിന്ന് ഹോൾസെയിൽ നിരക്കിൽ മാസത്തിലൊരിക്കൽ ബില്ല് ഈടാക്കുന്നു.

നിങ്ങൾ ഒരു പാനൽ ഹോസ്റ്റ്നാമം സജ്ജീകരിച്ചുകഴിഞ്ഞാൽ, അത് WordPress പ്ലഗിന്റെ Panel address ഫീൽഡിൽ മാത്രം നൽകുക — ഈ API നിർമ്മിക്കുന്ന സൈൻ-ഇൻ ലിങ്കുകൾ അത് സ്വയമേവ പിന്തുടരുന്നു.

അകത്തേക്ക് കടക്കാനുള്ള നാല് വഴികൾ

അകത്തേക്ക് കടക്കാൻ നാല് വഴികളുണ്ട്, അവ ഉള്ളിൽ ഒരേ കാര്യം തന്നെയാണ് ചെയ്യുന്നത്:

| | ഇതിനായി | |---|---| | WHMCS മൊഡ്യൂൾ | ഒരു WHMCS ഷോപ്പ് | | HostBill മൊഡ്യൂൾ | ഒരു HostBill ഷോപ്പ് | | WordPress പ്ലഗിൻ | നിങ്ങളുടെ സ്വന്തം WordPress അല്ലെങ്കിൽ WooCommerce സൈറ്റിൽ നിന്ന് വിൽക്കാൻ | | API | മറ്റേതെങ്കിലും — Blesta, ഇൻ-ഹൗസ് സിസ്റ്റം, ഒരു ക്രോൺ സ്ക്രിപ്റ്റ് |

1. ഒരു API കീ നേടുക

നിങ്ങളുടെ ഡാഷ്‌ബോർഡിൽ, API keys എന്നതിലേക്ക് പോയി ഒരെണ്ണം സൃഷ്ടിക്കുക. അതിന് ആവശ്യമായത് മാത്രം നൽകുക:

| അനുമതി (Permission) | കാരണം | |---|---| | org.read | നിങ്ങളുടെ ക്ലയന്റ് അക്കൗണ്ടുകൾ വായിക്കുക | | sites.create | ഒരു സൈറ്റ് പ്രൊവിഷൻ ചെയ്യുക | | sites.view | ഒരു സേവനം വായിക്കുക | | sites.delete | അവസാനിപ്പിക്കുക | | reseller.view | നിങ്ങളുടെ സേവനങ്ങൾ ലിസ്റ്റ് ചെയ്യുക, ഉപയോഗം വായിക്കുക | | reseller.provision | ഒരു ക്ലയന്റിനെ സസ്പെൻഡ് ചെയ്യുക, റിലീസ് ചെയ്യുക, സൈൻ ഇൻ ചെയ്യുക |

⛔ ഒരു ഇന്റഗ്രേഷന് reseller.manage നൽകരുത്. ആ അനുമതി നിങ്ങളുടെ വിലവിവരപ്പട്ടികയും നിങ്ങളുടെ സ്വന്തം പേയ്‌മെന്റ്-ഗേറ്റ്‌വേ ക്രെഡൻഷ്യലുകളും എഡിറ്റ് ചെയ്യുന്നു. നിങ്ങൾ ഒരു ബില്ലിംഗ് പാനലിലോ വെബ്‌സൈറ്റിലോ ഒട്ടിക്കുന്ന കീക്ക് അതിൻ്റെ ആവശ്യമില്ലാത്തതുകൊണ്ടാണ് കൃത്യമായി reseller.provision നിലവിലുള്ളത്.

കീ ഒരിക്കൽ കാണിക്കുന്നു. നിങ്ങളുടെ മറ്റ് ക്രെഡൻഷ്യലുകൾ എവിടെ സൂക്ഷിക്കുന്നുവോ അവിടെ സൂക്ഷിക്കുക — നിങ്ങളുടെ വെബ് സെർവർ സെർവ് ചെയ്യുന്ന ഒരു ഫയലിലും ഒരിക്കലും സൂക്ഷിക്കരുത്.

2. നിങ്ങളുടെ ആദ്യ കോൾ ചെയ്യുക

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

അത് നിങ്ങൾ പ്രൊവിഷൻ ചെയ്തിട്ടുള്ള ഓരോ സേവനവും, സൈറ്റിന് ഒരു വരി വീതം, അത് ഏത് ക്ലയന്റിന്റേതാണ്, അതിന്റെ സ്റ്റാറ്റസ്, നിങ്ങൾ അതിന് ഈടാക്കുന്നത് എത്രയാണ് എന്നിവ സഹിതം തിരികെ നൽകുന്നു. ഒരു പുതിയ അക്കൗണ്ടിൽ അതൊരു ശൂന്യമായ ലിസ്റ്റ് ആയിരിക്കും — അതൊരു പിഴവല്ല, ശരിയായ ഉത്തരമാണ്.

3. മുഴുവൻ ഇന്റഗ്രേഷനും, ആറ് കോളുകളിൽ

WHEN                 CALL
an order is paid     POST   /v1/orgs                                   once per CUSTOMER
                     POST   /v1/sites                                  once per SERVICE
they have not paid   POST   /v1/reseller/services/{siteId}/suspend
they pay             POST   /v1/reseller/services/{siteId}/unsuspend
they cancel          DELETE /v1/sites/{siteId}
"log in to hosting"  POST   /v1/reseller/services/{siteId}/sso

പ്രൊവിഷനിംഗ് രണ്ട് കോളുകളാണ്, കൂടാതെ കീകൾ പ്രധാനമാണ്:

# 1. the customer's account — keyed on YOUR customer id
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. their site — keyed on YOUR service id
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"}'

തെറ്റിയാൽ പണം നഷ്ടപ്പെടുന്ന രണ്ട് നിയമങ്ങൾ

1. നിങ്ങളുടെ കസ്റ്റമറിലാണ് അക്കൗണ്ട് കീ ചെയ്യേണ്ടത്, നിങ്ങളുടെ സർവീസിലാണ് സൈറ്റ് കീ ചെയ്യേണ്ടത്. ഒരു കസ്റ്റമറുടെ രണ്ടാമത്തെ ഓർഡർ അവർക്ക് ഇതിനകം ഉള്ള അക്കൗണ്ടിൽ തന്നെ എത്തണം. സർവീസിൽ രണ്ടും കീ ചെയ്യുകയാണെങ്കിൽ ഒരു കസ്റ്റമർ മൂന്ന് ബന്ധമില്ലാത്ത അക്കൗണ്ടുകളിലും മൂന്ന് വെവ്വേറെ പാനലുകളിലും എത്തിച്ചേരും.
2. ഏതൊരു വസ്തുവിനുമുള്ള നിങ്ങളുടെ സ്വന്തം ഐഡിയിൽ നിന്ന് നിർമ്മിച്ച ഒരു Idempotency-Key ഓരോ POST-ലും അയയ്ക്കുക. എല്ലാ ബില്ലിംഗ് സിസ്റ്റങ്ങളും വീണ്ടും ശ്രമിക്കുന്നു — ഒരു ഗേറ്റ്‌വേ കോൾബാക്ക് രണ്ടുതവണ വരുന്നു, ഒരു അഡ്മിൻ പരാജയപ്പെട്ട പ്രൊവിഷനിംഗ് വീണ്ടും പ്രവർത്തിപ്പിക്കുന്നു, ഒരു കസ്റ്റമർ ഇരട്ട ക്ലിക്ക് ചെയ്യുന്നു. കീ ഇല്ലെങ്കിൽ രണ്ടാമത്തെ ശ്രമം രണ്ടാമതൊരു സൈറ്റ് സൃഷ്ടിക്കുകയും അതിന് നിങ്ങളിൽ നിന്ന് ബില്ല് ഈടാക്കുകയും ചെയ്യും.

രണ്ടായി ചുരുക്കാൻ പാടില്ലാത്ത മൂന്ന് ഉത്തരങ്ങൾ

• unsuspend എന്നത് 409 തിരികെ നൽകാം. അതുകൊണ്ട് ഉദ്ദേശിക്കുന്നത് ഞങ്ങളുടെ ദുരുപയോഗ നിവാരണ ടീം (abuse team) സൈറ്റ് കൈവശം വച്ചിരിക്കുന്നു എന്നാണ്, നിങ്ങളല്ല. സന്ദേശം കാണിക്കുക; വീണ്ടും ശ്രമിക്കരുത്.
• **അവസാനിപ്പിക്കുന്നത് (Terminating) നീക്കംചെയ്യൽ ഷെഡ്യൂൾ ചെയ്യുന്നു, അത് നടപ്പിലാക്കുന്നില്ല.** തീയതി pending_deletion_at ആയി തിരിച്ചുവരുന്നു. ഡാറ്റ ഇതിനകം ഇല്ലാതായി എന്ന് ഒരു കസ്റ്റമറോട് പറയുന്നത്, ഒന്നും പറയാതിരിക്കുന്നതിനേക്കാൾ മോശമാണ്.
• disk_used_bytes എന്നത് null ആകാം, null എന്നാൽ പൂജ്യമല്ല. ഒന്നുമ ഉപയോഗിച്ചില്ല എന്നല്ല, ഞങ്ങൾക്ക് അളക്കാൻ കഴിഞ്ഞില്ല എന്നാണ് അതിനർത്ഥം. അത് ഒഴിവാക്കുക — നിങ്ങളുടെ സ്വന്തം റെക്കോർഡുകളിൽ 0 എഴുതരുത്, അല്ലാത്തപക്ഷം റീഡിംഗ് ലഭ്യമല്ലാത്ത ഒരു സൈറ്റിനായി നിങ്ങൾ കസ്റ്റമർക്ക് പച്ച നിറത്തിലുള്ള ഉപയോഗ ബാർ കാണിക്കും.

4. ഒരു ക്ലയന്റിനെ സൈൻ ഇൻ ചെയ്യുക

POST /v1/reseller/services/{siteId}/sso എന്നത് ഒറ്റത്തവണ മാത്രം ഉപയോഗിക്കാവുന്ന ഒരു URL തിരികെ നൽകുന്നു, അത് നിങ്ങളുടെ ക്ലയന്റിനെ ഇതിനകം സൈൻ ഇൻ ചെയ്തുകൊണ്ട് അവരുടെ സ്വന്തം അക്കൗണ്ടിലേക്ക് നേരിട്ട് എത്തിക്കുന്നു.

⛔ അവർ ക്ലിക്ക് ചെയ്യുമ്പോൾ ഇത് നിർമ്മിക്കുക, പേജ് റെൻഡർ ചെയ്യുമ്പോൾ ഒരിക്കലും ചെയ്യരുത്. ലിങ്ക് ഒറ്റത്തവണ മാത്രം ഉപയോഗിക്കാവുന്നതും മിനിറ്റുകൾക്കുള്ളിൽ കാലഹരണപ്പെടുന്നതുമാണ്, അതിനാൽ ഒരു പേജിൽ എഴുതിയിരിക്കുന്ന ലിങ്ക് ആദ്യത്തെ പേജ് വ്യൂവിൽ തന്നെ തീർന്നുപോവുകയും നിങ്ങളും ബ്രൗസറും തമ്മിലുള്ള എല്ലാ കാഷെയിലും അവശേഷിക്കുകയും ചെയ്യും.

5. പകരം ഒരു മൊഡ്യൂൾ ഇൻസ്റ്റാൾ ചെയ്യുക

• WHMCS — മൊഡ്യൂൾ modules/servers/zinn/-ലേക്ക് പകർത്തുക, Password നിങ്ങളുടെ API കീ ആയ ഒരു സെർവർ ചേർക്കുക, ഉൽപ്പന്നത്തിൽ ഉൽപ്പന്ന ലൈൻ സജ്ജമാക്കുക. Test Connection അമർത്തുക: ഇത് ഒരു യഥാർത്ഥ കോൾ ചെയ്യുകയും പ്ലാറ്റ്‌ഫോം എന്താണ് പറഞ്ഞതെന്ന് നിങ്ങളെ അറിയിക്കുകയും ചെയ്യും.
• HostBill — includes/modules/Hosting/zinn/-ലേക്ക് പകർത്തി അതുപോലെ തന്നെ കണക്റ്റുചെയ്യുക.
• WordPress — Zinn® Reseller Toolkit: ഡൊമെയ്ൻ തിരയൽ, നിങ്ങളുടെ ക്ലയന്റുകളുടെ ഹോസ്റ്റിംഗിലേക്കുള്ള സൈൻ-ഇൻ ലിങ്ക്, ഓർഡർ പെയ്ഡ് ആകുമ്പോൾ WooCommerce പ്രൊവിഷനിംഗ്. <https://github.com/Zinn-Digital/zinn-reseller-toolkit> എന്നതിൽ നിന്ന് ഓപ്പൺ സോഴ്സ് ലഭ്യമാണ്, അല്ലെങ്കിൽ നിങ്ങളുടെ ഡാഷ്‌ബോർഡിലെ Plugins എന്നതിൽ നിന്ന് ഇത് ഡൗൺലോഡ് ചെയ്യാം.

6. ലൈവ് ആകുക

നിങ്ങൾ ഒരു യഥാർത്ഥ ഓർഡർ സ്വീകരിക്കുന്നതിന് മുമ്പ് ഇവ പരിശോധിക്കുക:

• മൊഡ്യൂളിലെ കണക്ഷൻ ടെസ്റ്റ് വിജയിക്കുന്നു, അല്ലെങ്കിൽ നിങ്ങളുടെ ആദ്യത്തെ curl ഒരു ലിസ്റ്റ് തിരികെ നൽകുന്നു.
• നിങ്ങളുടെ വിലവിവരപ്പട്ടിക സജ്ജീകരിച്ചിരിക്കുന്നു (Reselling → Your prices).
• നിങ്ങളുടെ പേയ്‌മെന്റ് ഗേറ്റ്‌വേ കണക്റ്റുചെയ്‌തിരിക്കുന്നു (Reselling → Payment gateways) — നിങ്ങളുടെ ക്ലയന്റുകൾ അവരുടെ സ്വന്തം അക്കൗണ്ട് വഴി നിങ്ങൾക്ക് പണം നൽകുന്നു.
• നിങ്ങളുടെ കമ്പനി വിശദാംശങ്ങൾ നൽകിയിട്ടുണ്ട് (Reselling → Your company) അതുവഴി നിങ്ങളുടെ ക്ലയന്റ് ഇൻവോയ്സുകളിൽ ഞങ്ങളുടെതല്ല, നിങ്ങളുടെ നിയമപരമായ സ്ഥാപനത്തിന്റെ പേരും (legal entity) VAT നമ്പറും ഉണ്ടായിരിക്കും.
• നിങ്ങൾ ഒരു യഥാർത്ഥ ഓർഡർ അവസാനം വരെ നൽകുകയും സൈറ്റ് ദൃശ്യമാകുന്നത് കാണുകയും ചെയ്തിട്ടുണ്ട്.

മറ്റെല്ലാ കാര്യങ്ങളും എവിടെയാണ്

സമ്പൂർണ്ണ API റഫറൻസ് — ഓരോ എൻഡ്‌പോയിന്റും, ഞങ്ങളുടെ സ്പെസിഫിക്കേഷനിൽ നിന്ന് ജനറേറ്റ് ചെയ്തതും, ഓരോന്നിനും ആവശ്യമായ അനുമതിയോടുകൂടിയും — <https://zinndigital.com/developers/api> എന്ന വിലാസത്തിലാണ്.