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

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

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

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

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

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

ഇതിലേക്ക് പ്രവേശിക്കാനുള്ള നാല് വഴികൾ

ഇതിലേക്ക് നാല് വഴികളുണ്ട്, അവയെല്ലാം ആന്തരികമായി ഒരേ കാര്യമാണ് ചെയ്യുന്നത്:

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

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

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

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

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

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

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

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

എപ്പോൾ                കോൾ
ഒരു ഓർഡർ പണമടച്ചു     POST   /v1/orgs                                   ഒരു ഉപഭോക്താവിന് ഒരിക്കൽ വീതം
                     POST   /v1/sites                                  ഒരു സർവീസിന് ഒരിക്കൽ വീതം
അവർ പണമടച്ചിട്ടില്ല     POST   /v1/reseller/services/{siteId}/suspend
അവർ പണമടയ്ക്കുന്നു      POST   /v1/reseller/services/{siteId}/unsuspend
അവർ റദ്ദാക്കുന്നു        DELETE /v1/sites/{siteId}
"ഹോസ്റ്റിംഗിൽ ലോഗിൻ ചെയ്യുക" POST   /v1/reseller/services/{siteId}/sso

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

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

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

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

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

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

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

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

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

6. തത്സമയം ലഭ്യമാക്കുക

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

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

ബാക്കിയുള്ളവ എവിടെയാണുള്ളത്

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