GET/api/public/marketing

ڈیٹا بیس میں مینج کیے گئے تمام مارکیٹنگ صفحات یکجا فراہم کرتا ہے۔

`GET /api/public/marketing` شائع شدہ، ڈیٹا بیس میں مینج کیے گئے مارکیٹنگ مواد فراہم کرتا ہے جو عوامی صفحات کے لیے ہے۔ اس روٹ کے لیے لاگ ان ضروری نہیں اور یہ idempotent ہے۔ یہ صرف منظور شدہ مواد ہی واپس کر سکتا ہے، اور صرف وہ فیلڈز جو ڈسپلے کے لیے ضروری ہوں۔ اندرونی ڈرافٹس، انتظامی میٹا ڈیٹا اور غیر شائع شدہ ورژنز جواب میں شامل نہیں ہونے چاہییں۔ کلائنٹ مواد کو متعلقہ Slug یا Key کی بنیاد پر استعمال کرتا ہے۔ اگر کوئی اندراج موجود نہ ہو تو اسے خاموشی سے کسی دوسرے صفحے کے متن سے تبدیل نہیں کیا جانا چاہیے۔ اس کی جگہ ایک طے شدہ Fallback یا واضح "نہیں ملا" حالت ضروری ہے۔ اس سے یہ روکا جاتا ہے کہ مثلاً انٹیگریشن صفحے پر قیمت کا متن یا کسی دوسری زبان کے روٹ میں جرمن مواد ظاہر ہو۔ HTML مواد مقررہ ایڈیٹوریل ماخذ سے آنا چاہیے اور آؤٹ پٹ سے پہلے موجودہ سیکیورٹی قواعد کے مطابق پروسیس کیا جانا چاہیے۔ ٹوکنز، SQL کی تفصیلات، اندرونی IDs، ایڈیٹرز کے تبصرے اور ٹیسٹ ڈیٹا عوامی طور پر رینڈر نہیں ہونے چاہییں۔ زبان کے ورژنز الگ رہتے ہیں؛ کسی موجود نہ ہونے والے فرانسیسی یا عربی ریکارڈ کو مبینہ طور پر ترجمہ شدہ جرمن متن کے طور پر ظاہر نہیں کیا جانا چاہیے۔ چونکہ یہ روٹ کئی مواد ایک ساتھ فراہم کر سکتا ہے، اس لیے کیش اور اپ ڈیٹ کو سوچ سمجھ کر کنٹرول کیا جانا چاہیے۔ منظور شدہ مواد کی تبدیلی کے بعد عوامی ورژن کو اپ ڈیٹ ہونا چاہیے، بغیر پرانے اور نئے ورژنز کو ملائے۔ کلائنٹس کو صرف مطلوبہ اندراجات پروسیس کرنے چاہییں اور آبجیکٹ میں ترتیب سے کوئی مواد کا مفہوم اخذ نہیں کرنا چاہیے۔ ایک ٹیسٹ شائع شدہ Slugs، زبان، عنوان اور مواد کے ساتھ ساتھ ڈرافٹس اور اندرونی فیلڈز کے اخراج کو جانچتا ہے۔ اسے ریفرنس متن میں فرضی Rate-Limits، کامیابی کے ثبوت یا مارکیٹنگ کے وعدے شامل نہیں کرنے چاہییں۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

Idempotent (دہرانے پر یکساں اثر): جی ہاں

مثالی Response

{"ok":true,"data":{"preise":{"title":"قیمتیں","body_html":"...","updated_at":null,"version":0},"features":{...},"kontakt":{...},"ueber-uns":{...}}}

لائیو ٹیسٹ کا ثبوت

کامیابی (200) لائیو تصدیق شدہ۔

← عوامی مواد