Media

CDA (Content Delivery API) एक रीड-ओनली API है जो प्रकाशित संसाधनों को सार्वजनिक विज़िटर्स तक पहुँचाता है। यह पृष्ठ बताता है कि प्रकाशित Media, यानी छवि, वीडियो, दस्तावेज़ जैसी फ़ाइल एसेट्स को कैसे प्राप्त करें और उनका डिलीवरी पता कैसे लें। CDA प्रकाशन के समय का स्नैपशॉट पहुँचाता है, इसलिए कंटेंट स्टूडियो में अभी तक प्रकाशित न किए गए Media यहाँ दिखाई नहीं देते।

CDA में केवल पठन (GET) एंडपॉइंट हैं, और Media को अपलोड करने, बदलने तथा प्रकाशित करने का काम CMA Media संभालता है। प्रमाणीकरण और प्रकाशन डिलीवरी मॉडल (प्रकाशन स्नैपशॉट, revision, केवल प्रकाशित ही दिखता है) जैसे CDA के साझा व्यवहार के लिए CDA परिचय देखें। Media, अन्य प्रकाशित संसाधनों के विपरीत, लेखक जानकारी (createdBy, updatedBy) को हमेशा छोड़ देता है। title, description, file प्राप्त किए गए locale के एकल मान के रूप में लौटते हैं (locale=* हो तो पूरा मैप)।

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

नीचे दिखाया गया है कि CDA डेमो Space के एक प्रकाशित Media ("स्टेनलेस टम्बलर 500ml" उत्पाद चित्र) को locale=ko-KR के साथ एकल रूप में प्राप्त करके किस रूप में पहुँचाता है। sys (सिस्टम विशेषताएँ) के साथ, उस लोकेल के title, description, file वाला fields इसमें होता है।

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OGjUMsPV3uU",
    "type": "Media",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdAt": "2026-06-15T15:17:30.589Z",
    "updatedAt": "2026-06-15T15:17:30.810Z",
    "revision": 1
  },
  "fields": {
    "title": "스테인리스 텀블러 500ml 정면 컷",
    "description": "흰 배경에서 찍은 텀블러 정면 제품 사진입니다.",
    "file": {
      "fileName": "tumbler.png",
      "contentType": "image/png",
      "mimeGroups": ["Image"],
      "url": "https://weegloo-media.com/medias/HnQ32YiH/3uU/3trmXRM3RqbgSnifyg7OGjUMsPV3uU/ko-KR/1/tumbler.png",
      "detail": {
        "size": 50847,
        "image": { "width": 900, "height": 900 }
      }
    }
  }
}

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

• sys.id: Media का विशिष्ट पहचानकर्ता। यह एकल प्राप्ति पथ के {mediaId} में जाता है।
• sys.revision: सार्वजनिक किए जाने के समय का संस्करण। CDA प्रबंधन हेतु version शामिल नहीं करता, इसलिए प्रकाशन संस्करण की ओर इशारा करने वाला एकमात्र मान revision है।
• fields.title, fields.description: अनुरोधित locale का एकल मान (यह लोकेल मैप नहीं है)।
• fields.file: उस लोकेल की एक फ़ाइल को दर्शाने वाला ऑब्जेक्ट। विज़िटर को फ़ाइल दिखाने का डिलीवरी पता file.url है। ऑब्जेक्ट की कुंजियाँ नीचे fields में बताई गई हैं।

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

प्रकाशित Media का sys केवल प्रकाशन स्नैपशॉट के लिए आवश्यक विशेषताएँ रखता है। space, Refer रूप ({ "sys": { "id", "type": "Refer", "targetType" } }) में आता है।

चूँकि यह प्रकाशन स्नैपशॉट है, CMA के sys में मौजूद version, status, publish, archive इसमें नहीं रखे जाते। प्रकाशन संस्करण की ओर इशारा करने वाला एकमात्र मान revision है। लेखक जानकारी (createdBy, updatedBy) भी डिलीवरी प्रतिक्रिया में हमेशा छोड़ी जाती है।

fields

fields अनुरोधित locale का एकल मान रखता है। जहाँ CMA fields.title.ko-KR की तरह हर लोकेल के मानों वाला मैप लौटाता है, वहीं CDA अनुरोधित एक लोकेल का मान चुनकर सीधे डाल देता है।

file ऑब्जेक्ट की कुंजियाँ इस प्रकार हैं।

API

नीचे दिए दोनों एंडपॉइंट का आधार URL https://cda.weegloo.com/v1 है, और Authorization हेडर में CDA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। दोनों एंडपॉइंट locale क्वेरी पैरामीटर से प्राप्त की जाने वाली भाषा तय करते हैं। locale=ko-KR की तरह कोड देने पर उस लोकेल के मान के साथ, छोड़ देने पर Space के डिफ़ॉल्ट Locale के साथ, और locale=* होने पर पूरे लोकेल मैप के साथ लौटाते हैं। पहले दो मामलों में वास्तव में उपयोग किए गए लोकेल को बताने वाला x-weegloo-locale हेडर साथ आता है।

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

• CDA Content: Media को संदर्भित करने वाला प्रकाशित Content।
• CMA Media: Media को अपलोड और प्रबंधित करने वाला API।
• Media (अवधारणा): फ़ाइल एसेट्स को कंटेंट स्टूडियो में संभालने का तरीका।