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

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

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

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

| இடைமுகம் | யாருக்குரியது | |---|---| | உங்கள் சொந்த ஹோஸ்ட் பெயரில் ஹோஸ்டிங் பேனல் | Reselling → Your brand என்பதன் கீழ் பேனல் ஹோஸ்ட் பெயரை அமைக்கவும், உங்கள் வாடிக்கையாளர்கள் panel.yourcompany.com இல் உங்கள் லோகோ மற்றும் வண்ணங்களுடன் உள்நுழைவார்கள். அதே பேனல், உங்கள் முகவரி. | | உங்கள் சொந்த வலைத்தளம் | WordPress செருகுநிரல் டொமைன் தேடல் மற்றும் ஒரே கிளிக்கில் உள்நுழைவதற்கான இணைப்பை உங்கள் தளத்தில் வைக்கிறது, மேலும் உங்கள் சொந்த WooCommerce செக்அவுட் மூலம் ஆர்டரை எடுக்கிறது. | | உங்கள் பில்லிங் பேனல் | WHMCS அல்லது HostBill முன்பக்கத் தளமாக இருக்கும்; அதற்குப் பின்னால் உள்ள தொகுதி (module) தளத்தை உருவாக்குகிறது மற்றும் வாடிக்கையாளர் பகுதி பொத்தான் அவர்களை நேரடியாக அவர்களின் ஹோஸ்டிங்கில் உள்நுழை செய்கிறது. |

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

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

உள்ளே செல்வதற்கான நான்கு வழிகள்

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

| | எதற்காக | |---|---| | The WHMCS module | ஒரு WHMCS கடை | | The HostBill module | ஒரு HostBill கடை | | The WordPress plugin | உங்கள் சொந்த WordPress அல்லது WooCommerce தளத்திலிருந்து விற்பனை செய்ய | | The API | வேறு ஏதேனும் — Blesta, இன்-ஹவுஸ் சிஸ்டம், ஒரு cron ஸ்கிரிப்ட் |

1. API விசையைப் பெறுக (Get an API key)

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

| அனுமதி | ஏன் | |---|---| | org.read | உங்கள் வாடிக்கையாளர் கணக்குகளைப் படிக்க | | sites.create | ஒரு தளத்தை உருவாக்க | | sites.view | ஒரு சேவையைப் படிக்க | | sites.delete | முடிக்க | | reseller.view | உங்கள் சேவைகளைப் பட்டியலிட மற்றும் பயன்பாட்டைப் படிக்க | | reseller.provision | வாடிக்கையாளரை இடைநிறுத்த, விடுவிக்க மற்றும் உள்நுழைவு செய்ய |

⛔ ஒரு ஒருங்கிணைப்புக்கு (integration) reseller.manage வழங்க வேண்டாம். அந்த அனுமதி உங்கள் விலைப்பட்டியலையும் உங்கள் சொந்த கட்டண முறைக் சான்றுகளையும் திருத்துகிறது. பில்லிங் பேனல் அல்லது வலைத்தளத்தில் நீங்கள் ஒட்டும் விசைக்கு அந்த அனுமதி தேவையில்லை என்பதற்காகவே reseller.provision துல்லியமாக உள்ளது.

விசை ஒருமுறை காட்டப்படும். அதை உங்கள் மற்ற நற்சான்றிதழ்களை எங்கு சேமிக்கிறீர்களோ அங்கு சேமிக்கவும் - உங்கள் வலைச் சேவையகம் வழங்கும் கோப்பில் ஒருபோதும் சேமிக்க வேண்டாம்.

2. உங்கள் முதல் அழைப்பைச் செய்க (Make your first call)

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

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

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

4. வாடிக்கையாளரை உள்நுழைவு செய்க (Sign a client in)

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

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

5. அதற்குப் பதிலாக ஒரு தொகுதியை நிறுவவும் (Install a module instead)

• 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> இல் உள்ளது.