तुमच्या स्वतःच्या यंत्रणेवरून Zinn® होस्टिंग विकणे

तुम्ही आमचे होस्टिंग रिसेल करता. तुमचे क्लायंट तुमचेच आहेत: तुमच्या किमती, तुमचे इनव्हॉइस, तुमचा पेमेंट प्रदाता. तुम्ही आधीपासून चालवत असलेल्या कोणत्याही गोष्टीवरून — बिलिंग पॅनेल, तुमची स्वतःची WordPress साइट, किंवा स्क्रिप्ट — आमचे प्लॅटफॉर्म कसे चालवायचे हे याचे मार्गदर्शक आहे.

तुमच्या क्लायंटना प्रत्यक्षात काय दिसते

तांत्रिक बाबींच्या आधी: तुमच्या क्लायंटना आम्हाला कधीही पाहावे लागत नाही. तीन पृष्ठभाग, आणि तुम्ही यापैकी कोणता वापरायचा हे ठरवता.

| पृष्ठभाग | कोणाचा आहे | |---|---| | होस्टिंग पॅनेल, तुमच्या स्वतःच्या होस्टनेमवर | Reselling → Your brand अंतर्गत पॅनेल होस्टनेम सेट करा आणि तुमचे क्लायंट तुमच्या लोगो आणि रंगांसह panel.yourcompany.com वर साइन इन करतात. तेच पॅनेल, तुमचा पत्ता. | | तुमची स्वतःची वेबसाइट | WordPress प्लगइन तुमच्या साइटवर डोमेन शोध आणि वन-क्लिक साइन-इन लिंक ठेवते, आणि तुमच्या स्वतःच्या WooCommerce चेकआउटद्वारे ऑर्डर घेते. | | तुमचे बिलिंग पॅनेल | WHMCS किंवा HostBill फ्रंट डोअर म्हणून राहते; मॉड्युल त्यामागे प्रोव्हिजनिंग करते आणि क्लायंट-एरिया बटण त्यांना थेट त्यांच्या होस्टिंगमध्ये साइन इन करते. |

⛔ तुम्ही काहीही निवडा, तुमच्या क्लायंटसाठी तुम्ही मर्चंट ऑफ रेकॉर्ड आहात: तुमच्या किमती, तुमचे इनव्हॉइस, तुमचा व्हॅट नंबर, तुमचा पेमेंट प्रदाता. आम्ही घाऊक दरात, महिन्यातून एकदा, तुम्हाला बिलिंग करतो.

एकदा तुम्ही पॅनेल होस्टनेम सेट केले की, ते WordPress प्लगइनच्या Panel address फील्डमध्ये टाका आणि इतर कशातही नाही — हे API ज्या साइन इन लिंक्स तयार करते त्या त्याचे आपोआप अनुसरण करतात.

प्रवेश करण्याचे चार मार्ग

प्रवेश करण्याचे चार मार्ग आहेत, आणि ते अंतर्गत सर्व एकच गोष्ट करतात:

| | कोणासाठी | |---|---| | WHMCS मॉड्युल | एक WHMCS दुकान | | HostBill मॉड्युल | एक HostBill दुकान | | WordPress प्लगइन | तुमच्या स्वतःच्या WordPress किंवा WooCommerce साइटवरून विक्री करणे | | API | इतर काहीही — Blesta, इन-हाउस सिस्टीम, क्रॉन स्क्रिप्ट |

1. एक API की मिळवा

तुमच्या डॅशबोर्डमध्ये, API keys वर जा आणि एक तयार करा. त्याला फक्त त्याची गरज आहे तेच द्या:

| परवानगी | का | |---|---| | 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. संपूर्ण इंटिग्रेशन, सहा कॉल्समध्ये

कधी                    कॉल
ऑर्डर दिली जाते           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. तुमच्या ग्राहकावर खाते आणि तुमच्या सेवेवर साइट आधारीत करा. ग्राहकाची दुसरी ऑर्डर त्यांच्याकडे आधीपासून असलेल्या खात्यातच गेली पाहिजे. दोन्ही सेवेवर आधारित करा आणि एका क्लायंटकडे तीन संबंधित नसलेली खाती आणि तीन वेगळी पॅनेल समाप्त होतात.
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> वर आहे.