अपने स्वयं के सिस्टम से Zinn® होस्टिंग बेचना

आप हमारी होस्टिंग को रीसेल करते हैं। आपके ग्राहक आपके हैं: आपकी कीमतें, आपके इनवॉइस, आपका पेमेंट प्रोवाइडर। इस तरह आप उस किसी भी चीज़ से हमारे प्लेटफ़ॉर्म को संचालित करते हैं जिसे आप पहले से चला रहे हैं — एक बिलिंग पैनल, आपकी अपनी WordPress साइट, या कोई स्क्रिप्ट।

आपके ग्राहक वास्तव में क्या देखते हैं

प्रक्रिया से पहले: आपके ग्राहकों को कभी भी हमें देखने की आवश्यकता नहीं है। तीन माध्यम, और आप चुनते हैं कि आप किसका उपयोग करते हैं।

⛔ आप चाहे जिसे भी चुनें, आप अपने ग्राहकों के लिए मर्चेंट ऑफ रिकॉर्ड हैं: आपकी कीमतें, आपके इनवॉइस, आपका वैट नंबर, आपका पेमेंट प्रोवाइडर। हम थोक दर पर, महीने में एक बार, आपको बिल भेजते हैं।

एक बार जब आप पैनल होस्टनेम सेट कर लेते हैं, तो इसे 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. पूरा एकीकरण, छह कॉल्स में

कब                   कॉल
ऑर्डर का भुगतान हो   POST   /v1/orgs                                   प्रति CUSTOMER एक बार
                     POST   /v1/sites                                  प्रति SERVICE एक बार
उन्होंने भुगतान नहीं किया 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 दे सकता है। इसका मतलब है कि हमारी दुरुपयोग टीम ने साइट को रोक रखा है, आपने नहीं। संदेश दिखाएँ; इसका पुनः प्रयास न करें।
• **समाप्त करना विलोपन को शेड्यूल करता है, यह इसे तुरंत निष्पादित नहीं करता है।** तारीख 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) ताकि आपके ग्राहक इनवॉइस पर आपकी कानूनी इकाई और वैट नंबर हो, हमारा नहीं।
• आपने शुरू से अंत तक एक वास्तविक ऑर्डर दिया है और साइट को बनते हुए देखा है।

बाकी सब कुछ कहाँ है

पूर्ण API संदर्भ — प्रत्येक एंडपॉइंट, हमारे विनिर्देश से जनरेट किया गया, जिसमें से प्रत्येक के लिए आवश्यक अनुमति शामिल है — <https://zinndigital.com/developers/api> पर उपलब्ध है।