neभाषा
निःशुल्क सुरु गर्नुहोस्
लगइन गर्नुहोस्निःशुल्क सुरु गर्नुहोस्

ज्ञानकोष

तपाईंका आफ्नै प्रणालीहरूबाट Zinn® होस्टिङ बिक्री गर्दै

तपाईंको आफ्नै बिलिङ प्यानल, WordPress साइट वा स्क्रिप्टहरूबाट Zinn होस्टिङ सञ्चालन गर्नुहोस्: एउटा API की (API key) लिनुहोस्, आफ्नो पहिलो कल गर्नुहोस्, र सम्पूर्ण इन्टिग्रेसन बनेका बाँकी छ वटा कलहरू गर्नुहोस्।

तपाईं हाम्रो होस्टिंग पुन: बिक्री (re-sell) गर्नुहुन्छ। तपाईंका क्लाइन्टहरू तपाईंकै हुन्: तपाईंको मूल्यहरू, तपाईंका इनभ्वाइसहरू, तपाईंको भुक्तानी प्रदायक (payment provider)। तपाईंले पहिल्यै चलाइरहनुभएको जुनसुकै माध्यमबाट—बिलिङ प्यानल, तपाईंको आफ्नै WordPress साइट, वा कुनै स्क्रिप्ट—हाम्रो प्लेटफर्मलाई सञ्चालन गर्ने तरिका यही हो।

तपाईंका क्लाइन्टहरूले वास्तवमा के देख्छन्

प्राविधिक कुराभन्दा अगाडि: तपाईंका क्लाइन्टहरूले हामीलाई कहिल्यै देख्नुपर्दैन। तीनवटा इन्टरफेस (surfaces) छन्, र तपाईं कुन प्रयोग गर्ने भन्ने रोज्नुहुन्छ।

| इन्टरफेस | यो कसको हो | |---|---| | होस्टिंग प्यानल, तपाईंको आफ्नै होस्टनेममा | Reselling → Your brand अन्तर्गत प्यानलको होस्टनेम सेट गर्नुहोस् र तपाईंका क्लाइन्टहरूले panel.yourcompany.com मा तपाईंको लोगो र रंगहरूसँग साइन इन गर्छन्। प्यानल उही हो, ठेगाना तपाईंको। | | तपाईंको आफ्नै वेबसाइट | WordPress प्लगइनले तपाईंको साइटमा डोमेन खोज्ने सुविधा र एक-क्लिक साइन-इन लिंक राख्छ, र तपाईंको आफ्नै WooCommerce चेकआउटमार्फत अर्डर लिन्छ। | | तपाईंको बिलिङ प्यानल | WHMCS वा HostBill मुख्य ढोकाको रूपमा रहन्छ; त्यसको पछाडि मोड्युलले प्रोभिजन गर्छ र क्लाइन्ट-एरियाको बटनले उनीहरूलाई सिधै उनीहरूको होस्टिंगमा साइन इन गराउँछ। |

⛔ तपाईंले जुनसुकै रोज्नुहोस्, तपाईं आफ्ना क्लाइन्टहरूको लागि आधिकारिक बिक्रेता (merchant of record) हुनुहुन्छ: तपाईंको मूल्य, तपाईंको इनभ्वाइस, तपाईंको भ्याट नम्बर, तपाईंको भुक्तानी प्रदायक। हामी महिनाको एक पटक, होलसेल मूल्यमा तपाईंलाई बिल गर्छौं।

एक पटक प्यानलको होस्टनेम सेट गरेपछि, यसलाई WordPress प्लगइनको Panel address फिल्डमा मात्र राख्नुहोस्—अरू केहीमा होइन—यो API ले उत्पादन गर्ने साइन-इन लिंकहरूले यसलाई स्वतः पछ्याउँछन्।

भित्रिने चार तरिकाहरू

भित्रिने चारवटा तरिकाहरू छन्, र भित्री रूपमा ती सबैले एउटै काम गर्छन्:

| | यसको लागि | |---|---| | WHMCS मोड्युल | एक WHMCS पसल | | HostBill मोड्युल | एक HostBill पसल | | WordPress प्लगइन | तपाईंको आफ्नै WordPress वा WooCommerce साइटबाट बिक्री गर्न | | API | अन्य कुनै पनि कुरा — Blesta, आन्तरिक प्रणाली (in-house system), क्रोन स्क्रिप्ट (cron script) |

१. API की (API key) लिनुहोस्

तपाईंको ड्यासबोर्डमा गएर API keys मा जानुहोस् र एउटा सिर्जना गर्नुहोस्। यसलाई केवल आवश्यक पर्ने अधिकारहरू मात्र दिनुहोस्:

| अनुमति (Permission) | किन | |---|---| | org.read | तपाईंको क्लाइन्ट खाताहरू पढ्नुहोस् | | sites.create | साइट प्रोभिजन गर्नुहोस् | | sites.view | सेवा पढ्नुहोस् | | sites.delete | समाप्त गर्नुहोस् | | reseller.view | तपाईंको सेवाहरूको सूची हेर्नुहोस् र प्रयोग (usage) पढ्नुहोस् | | reseller.provision | क्लाइन्टलाई निलम्बन (suspend) गर्नुहोस्, रिलिज गर्नुहोस्, र साइन इन गर्नुहोस् |

⛔ कुनै पनि इन्टिग्रेशनलाई reseller.manage नदिनुहोस्। त्यो अनुमतिले तपाईंको मूल्यसूची र तपाईंको आफ्नै पेमेन्ट-गेटवे प्रमाणहरू (credentials) सम्पादन गर्छ। बिलिङ प्यानल वा वेबसाइटमा टाँस्ने (paste गर्ने) कीलाई यो नचाहियोस् भन्नकै लागि reseller.provision राखिएको हो।

की एक पटक मात्र देखाइन्छ। यसलाई आफ्ना अन्य प्रमाणहरू राख्ने ठाउँमै सुरक्षित राख्नुहोस्—वेब सर्भरले सेवा दिने कुनै पनि फाइलमा कहिल्यै नराख्नुहोस्।

२. पहिलो कल गर्नुहोस्

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

यसले तपाईंले प्रोभिजन गर्नुभएको प्रत्येक सेवा फिर्ता गर्छ, प्रति साइट एक पङ्क्तिमा, त्यो कुन क्लाइन्टको हो, यसको स्थिति (status), र तपाईंले यसको लागि कति शुल्क लिनुहुन्छ भन्ने सहित। नयाँ खातामा यो खाली सूची हुन्छ—जुन त्रुटि होइन, सही नतिजा हो।

३. सम्पूर्ण इन्टिग्रेशन, छ वटा कलहरूमा

कहिले (WHEN)          कल (CALL)
अर्डर भुक्तानी हुँदा    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

प्रोभिजनिङ भनेको दुईवटा कल हुन्, र कीहरू महत्त्वपूर्ण हुन्छन्:

# १. ग्राहकको खाता — तपाईंको ग्राहक आईडी (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"}'

# २. उनीहरूको साइट — तपाईंको सेवा आईडी (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"}'

दुई नियमहरू जसलाई गलत बुझ्दा लागत पर्छ

१. खातालाई आफ्नो ग्राहक (CUSTOMER) र साइटलाई आफ्नो सेवा (SERVICE) को आधारमा की (key) दिनुहोस्। ग्राहकको दोस्रो अर्डर उनीहरूसँग पहिले नै भएको खातामा जानुपर्छ। दुवैलाई सेवाको आधारमा मात्र की दिँदा एउटै ग्राहकका तीनवटा असम्बन्धित खाताहरू र तीनवटा छुट्टाछुट्टै प्यानलहरू बन्न पुग्छन्। २. प्रत्येक POST मा Idempotency-Key पठाउनुहोस्, जुन त्यो कुराको लागि तपाईंको आफ्नै आईडीबाट बनेको होस्। प्रत्येक बिलिङ प्रणालीले पुन: प्रयास (retry) गर्छ — गेटवे कलव्याक दुई पटक आउँछ, एडमिनले असफल भएको प्रोभिजन फेरि चलाउँछ, वा ग्राहकले डबल-क्लिक गर्छन्। की बिना, दोस्रो प्रयासले दोस्रो साइट सिर्जना गर्छ र तपाईंलाई त्यसको बिलिङ हुन्छ।

तीनवटा उत्तरहरू जसलाई दुईवटामा झार्नु हुँदैन

  • unsuspend ले 409 उत्तर दिन सक्छ। यसको मतलब हाम्रो दुरुपयोग (abuse) अनुसन्धान टोलीले साइट होल्ड गरेको छ, तपाईंले होइन। सन्देश देखाउनुहोस्; यसलाई पुन: प्रयास नगर्नुहोस्।
  • **समाप्त (Terminate) गर्दा मेट्ने कार्य तालिका (schedule) गरिन्छ, तुरुन्तै गरिँदैन।** मिति pending_deletion_at को रूपमा फिर्ता आउँछ। क्लाइन्टको डेटा मेटिएको छैन तर मेटियो भनेर बताउनु उनीहरूलाई केही पनि नबताउनु भन्दा नराम्रो हो।
  • disk_used_bytes null हुन सक्छ, र null भनेको शून्य होइन। यसको मतलब हामीले नाप्न सकेनौँ भन्ने हो, केही पनि प्रयोग भएको छैन भन्ने होइन। यसलाई छोड्नुहोस् — आफ्ना रेकर्डहरूमा 0 नलेख्नुहोस्, अन्यथा तपाईंले कुनै पनि रिडिङ नभएको साइटको लागि क्लाइन्टलाई हरियो प्रयोग बार (green usage bar) देखाउनुहुनेछ।

४. क्लाइन्टलाई साइन इन गराउनुहोस्

POST /v1/reseller/services/{siteId}/sso ले एउटा एकपटक मात्र प्रयोग गर्न मिल्ने (single-use) URL फर्काउँछ जसले क्लाइन्टलाई पहिल्यै साइन इन भइसकेको अवस्थामा सिधै उनीहरूको आफ्नै खातामा पुर्याउँछ।

⛔ पेज रेन्डर गर्दा होइन, उनीहरूले क्लिक गर्दा यसलाई उत्पादन (mint) गर्नुहोस्। यो लिङ्क एकपटक मात्र प्रयोग गर्न मिल्ने हो र केही मिनेटभित्रै म्याद समाप्त हुन्छ, त्यसैले पेजमा पहिले नै लेखिएको लिङ्क पहिलो पेज भ्युमै सकिन्छ र तपाईं र ब्राउजरबीचका सबै क्यासहरूमा बाँकी रहन्छ।

५. यसको सट्टा मोड्युल स्थापना गर्नुहोस्

  • WHMCS — मोड्युललाई modules/servers/zinn/ मा प्रतिलिपि (copy) गर्नुहोस्, एउटा सर्भर थप्नुहोस् जसको Password तपाईंको API key हो, र उत्पादनमा प्रोडक्ट लाइन सेट गर्नुहोस्। Test Connection थिच्नुहोस्: यसले वास्तविक कल गर्छ र प्लेटफर्मले के भन्यो भन्ने देखाउँछ।
  • HostBill — यसलाई includes/modules/Hosting/zinn/ मा प्रतिलिपि गर्नुहोस् र त्यसरी नै जडान गर्नुहोस्।
  • WordPress — Zinn® Reseller Toolkit: डोमेन खोज, क्लाइन्टहरूको होस्टिंगमा साइन-इन लिङ्क, र अर्डर भुक्तानी हुँदा WooCommerce प्रोभिजनिङ। खुला स्रोत (open source) <https://github.com/Zinn-Digital/zinn-reseller-toolkit> मा उपलब्ध छ, वा यसलाई तपाईंको ड्यासबोर्डको Plugins बाट डाउनलोड गर्नुहोस्।

६. लाइभ (Go live) हुनुहोस्

वास्तविक अर्डर लिनु अघि यी कुराहरू जाँच गर्नुहोस्:

  • मोड्युलमा जडान परीक्षण सफल हुन्छ, वा तपाईंको पहिलो curl ले सूची फर्काउँछ।
  • तपाईंको मूल्यसूची सेट गरिएको छ (Reselling → Your prices)।
  • तपाईंको पेमेन्ट गेटवे जडान गरिएको छ (Reselling → Payment gateways) — तपाईंका क्लाइन्टहरूले तपाईंको आफ्नै खातामार्फत भुक्तानी गर्छन्।
  • तपाईंको कम्पनीको विवरणहरू राखिएको छ (Reselling → Your company) जसले गर्दा तपाईंका क्लाइन्ट इनभ्वाइसहरूमा हाम्रो होइन, तपाईंको कानुनी संस्था (legal entity) र भ्याट नम्बर उल्लेख हुन्छ।
  • तपाईंले अन्त्यदेखि सुरुसम्म (end to end) एउटा वास्तविक अर्डर दिनुभएको छ र साइट देखापरेको हेर्नुभएको छ।

अन्य सबै कुराहरू कहाँ छन्

पूरा API सन्दर्भ (reference) — हाम्रो निर्दिष्टीकरण (specification) बाट उत्पन्न, प्रत्येकलाई चाहिने अनुमतिका साथ, प्रत्येक इन्न्डपोइन्ट — <https://zinndigital.com/developers/api> मा उपलब्ध छ।

अझै पनि अल्झिनुभयो?

प्रत्येक प्लानमा सहयोग समावेश छ र तपाईंको आफ्नै भाषामा उत्तरहरू पाइन्छ।

सम्पर्क समर्थन → सबै लेखहरू →

हामी साइट कसरी प्रयोग गरिन्छ भनेर बुझ्न एनालिटिक्स कुकीहरू प्रयोग गर्छौं। तिनीहरू तपाईंले स्वीकार गरेमा मात्र सेट हुन्छन्। कुकी नीति

तपाईंका आफ्नै प्रणालीहरूबाट Zinn® होस्टिङ बिक्री गर्दै