உங்கள் சொந்த அமைப்புகளிலிருந்து Zinn® ஹோஸ்டிங்கை விற்பனை செய்தல்

நீங்கள் எங்கள் ஹோஸ்டிங்கை மறுவிற்பனை செய்கிறீர்கள். உங்கள் வாடிக்கையாளர்கள் உங்களுடையவர்கள்: உங்கள் விலைகள், உங்கள் விலைப்பட்டியல்கள், உங்கள் கட்டணச் சேவை வழங்குநர். நீங்கள் ஏற்கனவே இயக்கும் ஒன்றிலிருந்து — ஒரு பில்லிங் பேனல், உங்கள் சொந்த WordPress தளம், அல்லது ஒரு ஸ்கிரிப்ட் — எங்கள் தளத்தை எவ்வாறு இயக்குவது என்பது இங்கே கொடுக்கப்பட்டுள்ளது.

உங்கள் வாடிக்கையாளர்கள் உண்மையில் எதைப் பார்க்கிறார்கள்

தொழில்நுட்ப விவரங்களுக்கு முன்: உங்கள் வாடிக்கையாளர்கள் எங்களை ஒருபோதும் பார்க்க வேண்டியதில்லை. மூன்று இடைமுகங்கள் உள்ளன, நீங்கள் எதைப் பயன்படுத்துவது என்பதை நீங்கள் தேர்வு செய்யலாம்.

⛔ நீங்கள் எதைத் தேர்ந்தெடுத்தாலும், உங்கள் வாடிக்கையாளர்களுக்கான விற்பனையாளர் நீங்கள்தான்: உங்கள் விலைகள், உங்கள் விலைப்பட்டியல்கள், உங்கள் VAT எண், உங்கள் கட்டணச் சேவை வழங்குநர். நாங்கள் மொத்த விற்பனை விலையில், மாதத்திற்கு ஒரு முறை உங்களுக்குக் கட்டணம் விதிப்போம்.

நீங்கள் பேனல் ஹோஸ்ட் பெயரை அமைத்தவுடன், அதை WordPress செருகுநிரலின் Panel address புலத்தில் மட்டும் உள்ளிடவும், வேறு எதிலும் உள்ளிட வேண்டாம் — இந்த API உருவாக்கும் உள்நுழைவு இணைப்புகள் தானாகவே அதைப் பின்பற்றும்.

இணைப்பதற்கான நான்கு வழிகள்

இணைக்க நான்கு வழிகள் உள்ளன, மேலும் அவை அனைத்தும் உட்புறத்தில் ஒரே காரியத்தைச் செய்கின்றன:

1. ஒரு API விசையைப் பெறுங்கள்

உங்கள் டாஷ்போர்டில், API keys என்பதற்குச் சென்று ஒன்றை உருவாக்கவும். அதற்குத் தேவையானதை மட்டுமே வழங்கவும்:

⛔ ஒரு ஒருங்கிணைப்புக்கு 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. கணக்கை உங்கள் CUSTOMER மீதும், தளத்தை உங்கள் SERVICE மீதும் முதன்மைப்படுத்தவும் (Key). வாடிக்கையாளரின் இரண்டாவது ஆர்டர் அவர்கள் ஏற்கனவே வைத்துள்ள கணக்கில் சேர வேண்டும். இரண்டையும் சேவையின் மீது முதன்மைப்படுத்தினால், ஒரு வாடிக்கையாளருக்கு தொடர்பில்லாத மூன்று கணக்குகளும் மூன்று தனித்தனி பேனல்களும் உருவாகிவிடும்.
2. ஒவ்வொரு POST அழைப்பிலும், அந்தப் பொருளுக்கான உங்கள் சொந்த அடையாளக் குறியீட்டிலிருந்து உருவாக்கப்பட்ட Idempotency-Key ஒன்றை அனுப்பவும். ஒவ்வொரு பில்லிங் அமைப்பும் மீண்டும் முயற்சிக்கும் — ஒரு கேட்வே கால்பேக் இரண்டு முறை வரலாம், ஒரு நிர்வாகி தோல்வியுற்ற புரோவிஷனை மீண்டும் இயக்கலாம், ஒரு வாடிக்கையாளர் இருமுறை கிளிக் செய்யலாம். விசை இல்லாமல் இருந்தால் இரண்டாவது முயற்சி இரண்டாவது தளத்தை உருவாக்கும், அதற்கான கட்டணம் உங்களிடம் வசூலிக்கப்படும்.

நீங்கள் இரண்டாகக் குறைக்கக் கூடாத மூன்று பதில்கள்

• unsuspend என்பது 409 எனப் பதிலளிக்கலாம். அதாவது எங்கள் முறைகேடு தடுப்புக் குழு தளத்தை நிறுத்தி வைத்துள்ளது, நீங்கள் அல்ல என்று அர்த்தம். செய்தியைக் காட்டுங்கள்; மீண்டும் முயற்சிக்க வேண்டாம்.
• **சேவையை நிறுத்துவது (Terminating) ஒரு நீக்கத்தைத் திட்டமிடுகிறது, உடனடியாக நீக்காது.** தேதி pending_deletion_at ஆகத் திரும்ப வரும். வாடிக்கையாளரின் தரவு இன்னும் இருக்கும்போது அது ஏற்கனவே நீக்கப்பட்டுவிட்டது என்று சொல்வது, எதுவும் சொல்லாமல் இருப்பதை விட மோசமானது.
• disk_used_bytes என்பது null ஆக இருக்கலாம், மேலும் null என்பது பூஜ்ஜியம் அல்ல. எங்களால் அளவிட முடியவில்லை என்று அர்த்தமே தவிர, எதுவும் பயன்படுத்தப்படவில்லை என்று அர்த்தமல்ல. அதைத் தவிர்க்கவும் — உங்கள் சொந்தப் பதிவுகளில் 0 என்று எழுத வேண்டாம், அவ்வாறு செய்தால் நீங்கள் எந்த அளவீடும் பெறாத ஒரு தளத்திற்கு வாடிக்கையாளருக்குப் பச்சைப் பயன்பாட்டுப் பட்டையைக் காட்டுவீர்கள்.

4. ஒரு வாடிக்கையாளரை உள்நுழைய வைக்கவும்

POST /v1/reseller/services/{siteId}/sso என்பது உங்கள் வாடிக்கையாளரை நேரடியாக அவர்களின் சொந்தக் கணக்கிற்குள், ஏற்கனவே உள்நுழைந்த நிலையில் கொண்டு சேர்க்கும் ஒரு முறை மட்டுமே பயன்படுத்தக்கூடிய URL-ஐ வழங்குகிறது.

⛔ அவர்கள் கிளிக் செய்யும் போது மட்டுமே அதை உருவாக்குங்கள், பக்கத்தை ரெண்டர் செய்யும் போது ஒருபோதும் உருவாக்க வேண்டாம். இந்த இணைப்பு ஒரு முறை மட்டுமே பயன்படுத்தக்கூடியது மற்றும் சில நிமிடங்களில் காலாவதியாகிவிடும், எனவே ஒரு பக்கத்தில் எழுதப்பட்ட இணைப்பு முதல் பக்கப் பார்வையிலேயே முடிந்துவிடும் மற்றும் உங்களுக்கும் உலாவிக்கும் இடையில் உள்ள ஒவ்வொரு தேக்ககத்திலும் (cache) தங்கிவிடும்.

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. பயன்பாட்டிற்கு கொண்டு வாருங்கள் (Go live)

உண்மையான ஆர்டரை எடுப்பதற்கு முன் இவற்றைச் சரிபார்க்கவும்:

• தொகுதியில் இணைப்பு சோதனை வெற்றிகரமாக உள்ளது, அல்லது உங்கள் முதல் curl ஒரு பட்டியலை வழங்குகிறது.
• உங்கள் விலைப்பட்டியல் அமைக்கப்பட்டுள்ளது (Reselling → Your prices).
• உங்கள் கட்டண நுழைவாயில் இணைக்கப்பட்டுள்ளது (Reselling → Payment gateways) — உங்கள் வாடிக்கையாளர்கள் உங்கள் சொந்த கணக்கின் மூலம் உங்களுக்கு பணம் செலுத்துகிறார்கள்.
• உங்கள் நிறுவன விவரங்கள் உள்ளிடப்பட்டுள்ளன (Reselling → Your company), எனவே உங்கள் வாடிக்கையாளர் விலைப்பட்டியல்களில் எங்கள் விவரங்கள் அல்லாமல், உங்கள் சட்டப்பூர்வ நிறுவனம் மற்றும் VAT எண் இருக்கும்.
• நீங்கள் தொடக்கம் முதல் முடிவு வரை ஒரு உண்மையான ஆர்டரைச் செய்து தளம் தோன்றுவதைப் பார்த்துள்ளீர்கள்.

மற்ற அனைத்தும் எங்கு உள்ளன

ஒவ்வொரு எண்ட்பாயிண்ட், எங்கள் விவரக்குறிப்பிலிருந்து உருவாக்கப்பட்டது, ஒவ்வொன்றிற்கும் தேவையான அனுமதியுடன் கூடிய முழுமையான API குறிப்பு <https://zinndigital.com/developers/api> இல் உள்ளது.