Upload API

अंतिम अपडेट: 3 जुलाई 2026

Upload एक अस्थायी संसाधन है जो फ़ाइल अपलोड करके बनाया जाता है। यह Media बनाने से पहले का पहला चरण है: फ़ाइल अपलोड करने पर प्रतिक्रिया में एक Upload लौटता है, और इस Upload की जानकारी के साथ Media बनाया जाता है। Media का निर्माण CMA(Weegloo User) या ACMA(Service User) में होता है और यह इस पेज के दायरे से बाहर है।

Upload एक अस्थायी संसाधन है। बनने के 24 घंटे बाद यह समाप्त हो जाता है(expiresAt), और उस अवधि के भीतर इसे Media में नहीं बदला गया तो यह गायब हो जाता है। Upload में प्रकाशन या संस्करण की अवधारणा नहीं है(version, status, publish गुण नहीं होते)। इसमें कोई बॉडी फ़ील्ड भी नहीं होती और केवल सिस्टम गुण sys होता है। बेस URL https://upload.weegloo.com/v1 है, और हर अनुरोध के लिए Upload को प्रमाणित करने वाला Bearer टोकन आवश्यक है।

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

नीचे एक कपड़े की दुकान के उत्पाद फ़ोटो(टम्बलर इमेज) को एक Space में अपलोड किए गए Upload की प्रतिक्रिया है। इसमें केवल sys है, और उसके अंदर owner, expiresAt, size जैसी कुंजियाँ होती हैं।

{
  "sys": {
    "id": "4bgMfu7cFGYDRQn4jdqFI8tkOWKZIm",
    "type": "Upload",
    "owner": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-18T04:48:44.057Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-18T04:48:44.057Z",
    "expiresAt": "2026-06-19T04:48:44.057Z",
    "size": 50847
  }
}

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

  • sys.id: Upload का विशिष्ट पहचानकर्ता। Media बनाते समय यह मान पास किया जाता है। एकल पठन, विलोपन पथ के {uploadId} में भी यही जाता है।
  • sys.owner: यह संदर्भ इंगित करता है कि यह Upload कहाँ से संबंधित है। targetType Space या Organization होता है(नीचे Space और Organization संदर्भ देखें)।
  • sys.expiresAt: समाप्ति समय। यह createdAt से 24 घंटे बाद होता है, और यह समय बीत जाने पर Upload गायब हो जाता है।
  • sys.size: अपलोड की गई फ़ाइल का आकार(बाइट में)। उपरोक्त उदाहरण 50847 बाइट है।

सिस्टम गुण (sys)

हर Upload अपने सिस्टम गुण sys ऑब्जेक्ट में रखता है। owner, createdBy, updatedBy Refer आकार({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं।

गुणप्रकारविवरण
idstringसंसाधन का विशिष्ट पहचानकर्ता।
typestringसंसाधन का प्रकार। Upload हमेशा "Upload" होता है।
ownerReferयह Upload जहाँ से संबंधित है। targetType Space या Organization होता है।
createdByRefer<User>बनाने वाला उपयोगकर्ता।
createdAtstring (date-time)निर्माण का समय।
updatedByRefer<User>अंतिम बार संशोधित करने वाला उपयोगकर्ता।
updatedAtstring (date-time)अंतिम संशोधन का समय।
expiresAtstring (date-time)समाप्ति का समय। यह createdAt से 24 घंटे बाद होता है, और बीत जाने पर Upload गायब हो जाता है।
sizeinteger (int64)अपलोड की गई फ़ाइल का आकार(बाइट में)।

उपरोक्त 9 गुण सभी प्रतिक्रिया में हमेशा शामिल होते हैं। Content या Content Type के sys में मौजूद version, status, publish Upload में नहीं होते। ऐसा इसलिए है क्योंकि Upload कोई प्रकाशित या संस्करणित किया जाने वाला संसाधन नहीं है, बल्कि Media बनाने के लिए एक एक-बार उपयोग होने वाली सामग्री है। owner अन्य संसाधनों के space की तरह केवल एक प्रकार को इंगित नहीं करता, बल्कि targetType के अनुसार Space या Organization को इंगित करता है।

Space और Organization संदर्भ

Upload दो संदर्भों में बनाया जा सकता है, और संदर्भ के अनुसार पथ और sys.owner बदलते हैं।

संदर्भपथ आधारsys.owner.sys.targetTypeउपयोग
Space/spaces/{spaceId}/uploadsSpaceउत्पाद फ़ोटो जैसी, जो Media की सामग्री बनेगी, वैसी फ़ाइल।
Organization/organizations/{organizationId}/uploadsOrganizationसंगठन के आइकन जैसी संगठन-स्तरीय संपत्ति।

Space संदर्भ का Upload उस Space के Media बनाने की सामग्री है। Organization संदर्भ का Upload संगठन के आइकन जैसी, संगठन में सीधे उपयोग होने वाली फ़ाइल अपलोड करते समय उपयोग होता है। दोनों मामलों में प्रतिक्रिया में लौटने वाली संसाधन संरचना समान होती है, केवल sys.owner का targetType मान भिन्न होता है।

अपलोड का तरीका: multipart और binary

फ़ाइल अपलोड करने वाले POST अनुरोध के दो तरीके हैं। चाहे कोई भी हो, प्रतिक्रिया में लौटने वाला संसाधन समान Upload होता है।

multipart तरीका अनुरोध बॉडी को multipart/form-data के रूप में भेजता है। फ़ाइल को file नाम वाली फ़ॉर्म फ़ील्ड में रखा जाता है। यह उन स्थितियों के लिए उपयुक्त है जहाँ फ़ॉर्म डेटा के रूप में भेजा जाता है, जैसे ब्राउज़र के फ़ाइल चयन इनपुट से सीधे अपलोड करना।

binary तरीका फ़ाइल के मूल बाइट्स को अनुरोध बॉडी में ज्यों का त्यों रखता है। बॉडी के मीडिया प्रकार(Content-Type) पर कोई बंधन नहीं है(आमतौर पर application/octet-stream का उपयोग होता है), और Space संदर्भ में Content-Length हेडर में बॉडी की बाइट लंबाई भी भेजनी होती है। यह उन सर्वर-साइड कोड जैसी स्थितियों के लिए उपयुक्त है जो फ़ॉर्म संरचना के बिना केवल फ़ाइल बाइट्स भेजते हैं।

API

नीचे दिए गए सभी एंडपॉइंट्स का आधार URL https://upload.weegloo.com/v1 है, और Authorization हेडर में Upload को प्रमाणित करने वाला Bearer टोकन आवश्यक है। पहले Space संदर्भ के 4, फिर Organization संदर्भ के 4 एंडपॉइंट दिए गए हैं।

  • Media: अपलोड किए गए Upload से Media बनाने का अनुरोध प्रारूप।
  • Media (अवधारणा): फ़ाइल संपत्तियों को कंटेंट स्टूडियो में संभालने का तरीका।