Web Hosting

Web Hosting एक ऐसा संसाधन है जो आपकी बनाई हुई स्टैटिक वेबसाइट को Space पर अपलोड करके {subdomain}.weegloo.app पते से सेवा देता है. कपड़ों की दुकान वाले ऑनलाइन स्टोर का उदाहरण लें, तो बनाई हुई शॉपिंग मॉल साइट को dailywear-shop.weegloo.app पर चलाना एक Web Hosting है.

अपलोड करने का क्रम इस प्रकार है. पहले बिल्ड के परिणाम को ZIP या tar.gz में पैक करके Upload API से अपलोड करके एक Upload प्राप्त करें. उस Upload को संदर्भित करके POST /web-hostings से Web Hosting बनाएं. सिस्टम अपलोड की गई फ़ाइलों को प्रोसेस करता है और जब sys.state COMPLETED हो जाता है, तो आप url से साइट तक पहुंच सकते हैं. CMA में Web Hosting Space का उप-संसाधन है, और इसका पथ /spaces/{spaceId}/web-hostings पर आधारित होता है.

संसाधन संरचना

नीचे प्रोसेसिंग पूरी हो चुके Web Hosting "DailyWear स्टोर साइट" के एकल पुनर्प्राप्ति की प्रतिक्रिया दी गई है. यह sys (सिस्टम विशेषताएं) के साथ मुख्य विशेषताएं (name, description, isSpa, subdomain, url) रखता है.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PWeb01Examp",
    "type": "WebHosting",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-18T11:40:00.000Z",
    "updatedAt": "2026-06-18T11:40:05.000Z",
    "state": "COMPLETED",
    "totalFileSize": 245786,
    "version": 3
  },
  "name": "DailyWear स्टोर साइट",
  "description": "कपड़ा और एक्सेसरीज़ स्टोर के लिए स्थैतिक साइट",
  "isSpa": true,
  "subdomain": "dailywear-shop",
  "url": "https://dailywear-shop.weegloo.app"
}

मुख्य कुंजियां:

• subdomain: वह सबडोमेन जिस पर साइट सेवा देगी. ऊपर के उदाहरण में यह dailywear-shop है, और अंतिम पता dailywear-shop.weegloo.app बनता है.
• url: प्रोसेसिंग पूरी होने के बाद जिस पते पर पहुंचा जा सकता है, वह साइट का पता है.
• isSpa: सिंगल-पेज ऐप (SPA) है या नहीं. true होने पर सभी पथ अनुरोधों को index.html पर भेजता है.
• state: अपलोड की गई फ़ाइलों की परिनियोजन प्रोसेसिंग स्थिति. इसे नीचे सिस्टम विशेषताएं (sys) में समझाया गया है.

सिस्टम विशेषताएं (sys)

हर Web Hosting सामान्य सिस्टम विशेषताओं को sys ऑब्जेक्ट में रखता है. space, createdBy, updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं.

state अपलोड की गई फ़ाइलों को परिनियोजित करने के प्रोसेसिंग चरण को दर्शाता है. यह Content की प्रकाशन स्थिति नहीं है, और Web Hosting में प्रकाशन या संग्रह की कोई अवधारणा नहीं है. फ़ाइलों को प्रोसेस करके COMPLETED हो जाने पर url से साइट तक पहुंचा जा सकता है.

मुख्य विशेषताएं

Web Hosting की मुख्य विशेषताएं इस प्रकार हैं.

सबडोमेन की जांच

Web Hosting बनाने से पहले आप यह जांच सकते हैं कि जिस सबडोमेन का उपयोग करना है वह खाली है या नहीं. GET /web-hostings/availability?subdomain=... पर जांच किए जाने वाले सबडोमेन को subdomain क्वेरी के रूप में भेजें.

प्रतिक्रिया निम्नलिखित आकार की होती है, और यदि available true है, तो उस सबडोमेन का उपयोग किया जा सकता है.

{ "subdomain": "dailywear-shop", "available": true }

कस्टम डोमेन

डिफ़ॉल्ट पते {subdomain}.weegloo.app के बजाय आप अपने स्वामित्व वाले डोमेन को Web Hosting से जोड़ सकते हैं. जोड़े गए डोमेन की स्थिति customDomain ऑब्जेक्ट से दर्शाई जाती है, और इसका आकार { id, domain, dns, cert } है. dns और cert क्रमशः डोमेन स्वामित्व सत्यापन (DNS) और प्रमाणपत्र जारी होने (cert) की स्थिति हैं, और दोनों का आकार { status, txtName, txtContent } है. txtName, txtContent डोमेन की ओर पंजीकृत किए जाने वाले DNS TXT रिकॉर्ड का नाम और मान हैं.

{
  "id": 1024,
  "domain": "shop.dailywear.example",
  "dns": {
    "status": "PENDING",
    "txtName": "_weegloo.shop.dailywear.example",
    "txtContent": "weegloo-verify=3trmXRM3RqbgSnifyg7PWebVerifyEx"
  },
  "cert": {
    "status": "PENDING",
    "txtName": "_acme-challenge.shop.dailywear.example",
    "txtContent": "acme-verify=3trmXRM3RqbgSnifyg7PWebCertEx"
  }
}

डोमेन की ओर TXT रिकॉर्ड पंजीकृत करने के बाद PUT /web-hostings/{webHostingId}/custom-domain/status/verify से सत्यापन ट्रिगर करें, और वर्तमान स्थिति GET /web-hostings/{webHostingId}/custom-domain/status से पुनर्प्राप्त करें. सत्यापन पूरा होने पर dns.status, cert.status VERIFIED हो जाते हैं. जिस Web Hosting से कस्टम डोमेन नहीं जोड़ा गया है, उस पर स्थिति पुनर्प्राप्ति कॉल करने पर WGL404001 के साथ प्रतिक्रिया मिलती है.

API

नीचे दिए गए सभी एंडपॉइंट्स का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है. संशोधन, आंशिक संशोधन के लिए आशावादी समवर्तीता नियंत्रण हेतु X-Weegloo-Version हेडर (वर्तमान संसाधन का sys.version) भी भेजना आवश्यक है. बनाने, विलोपन अनुरोधों में यह हेडर नहीं होता.

संबंधित दस्तावेज़

• Upload API: स्टैटिक फ़ाइल ZIP अपलोड करके Web Hosting निर्माण में उपयोग होने वाला Upload प्राप्त करने का अनुरोध.
• Space: वह Space जिससे Web Hosting संबंधित है.