GET/api/public/legal/:slug
ایک واحد قانونی متن HTML کے طور پر فراہم کرتا ہے۔
صفحہ „GET /api/public/legal/:slug — API حوالہ“ URL میں بیان کردہ فنکشنل شعبے سے متعلق ہے۔ موجودہ مواد میں اصل طریقۂ کار، شرائط اور معلوم حدود کا اضافہ کیا گیا ہے۔ Zentor کے پاس ڈیولپر API کلید کا کوئی نظام نہیں ہے۔ ڈیش بورڈ کے لیے بارہ گھنٹے کی مدت والے سیشن JWTs اور سات دن کی مدت والے ریفریش ٹوکنز استعمال ہوتے ہیں؛ TOTP اور SSO اختیاری ہیں۔ ویجیٹ ایمبیڈ ٹوکنز صرف ایک بار سادہ متن میں دکھائے جاتے ہیں اور منظور شدہ Origins سے منسلک ہوتے ہیں۔ `GET /api/public/legal/:slug` کی دستاویزات کو لازمی طور پر اس مخصوص اینڈ پوائنٹ کی تکنیکی وضاحت کے طور پر پڑھا جانا چاہیے۔ فیصلہ کن عناصر طریقہ، راستہ، تصدیقِ شناخت، لازمی فیلڈز، ممکنہ خرابیاں اور یہ سوال ہیں کہ آیا دوبارہ کال کرنے سے وہی اثر پیدا ہوتا ہے۔ اس لیے مدد کا یہ حصہ https://zentor-app.de/hilfe/api-referenz/oeffentliche-inhalte/content.legal_by_slug کوئی عمومی تشہیری بیانات شامل نہیں کر سکتا، بلکہ صرف اس کے بعد قابلِ فہم انٹیگریشن کے مراحل اور ثابت شدہ جوابی مثالیں۔ `/api/public/legal/:slug` کو کال کرنے کے لیے درخواست Registry کے مطابق تیار کی جاتی ہے۔ عوامی راستوں کو کسی عمومی ڈیولپر API کلید کی ضرورت نہیں، کیونکہ Zentor ایسا کوئی کلیدی نظام پیش نہیں کرتا۔ اس کے برعکس محفوظ ویجیٹ راستے ایک بار دکھایا گیا ایمبیڈ ٹوکن اور Origin کی جانچ استعمال کرتے ہیں۔ HTTP اسٹیٹس اور JSON مواد کا ایک ساتھ تجزیہ کیا جانا ضروری ہے؛ صرف `ok` فیلڈ خرابی سے نمٹنے کا متبادل نہیں ہے۔ `GET /api/public/legal/:slug` کی جانچ کرتے وقت گمنام بنائی گئی قدریں استعمال کی جائیں۔ حقیقی گاہکوں کا ڈیٹا، پروڈکشن UUIDs، سیشن ٹوکنز اور مخصوص ٹائم اسٹیمپس عوامی مثالوں میں شامل نہیں ہونے چاہئیں۔ پلیٹ فارم کی سطح پر معلوم حد 15 منٹ میں 2,000 درخواستیں ہے؛ کسی مختلف انفرادی حد کا ثبوت موجود نہیں۔ غیر idempotent POST کالز کو غیر واضح نیٹ ورک انقطاع کے بعد آنکھیں بند کر کے دہرایا نہیں جانا چاہیے۔ اس راستے کے لیے عام انٹیگریشن خرابیاں لازمی پیرامیٹرز کی عدم موجودگی، غلط ڈیٹا ٹائپس، میعاد ختم شدہ یک بارہ کوڈز، غیر اجازت یافتہ Origins یا غیر نافذ شدہ ڈیٹا ریکارڈ کی وجہ سے پیدا ہوتی ہیں۔ ایپلیکیشن کو ایسے معاملات الگ الگ سنبھالنے چاہئیں اور اینڈ پوائنٹ سے واپس آنے والے خرابی کے پیغام کو لاگ کرنا چاہیے، خفیہ مواد درج کیے بغیر۔ ایک کامیاب Request صرف اسی پراسیسنگ مرحلے کی تصدیق کرتی ہے، بعد میں آنے والی ای میل، ادائیگی یا SSO کی کامیابی کی خودکار طور پر نہیں۔ یہ „GET /api/public/legal/:slug“ کے لیے براہِ راست متعلقہ ہے۔ اس صفحے کی تکنیکی جانچ لازمی طور پر `app/frontend/src/content/api-reference/` کے تحت Registry اور متعلقہ بیک اینڈ راستوں پر مبنی ہونی چاہیے۔ لائیو ٹیسٹ نوٹس صرف وہی دعویٰ کر سکتے ہیں جو واقعی جانچا گیا ہو۔ کوئی منفی ٹیسٹ یا کوڈ کی مماثلت کامیابی کا مکمل ثبوت نہیں ہے۔ اس لیے GET /api/public/legal/:slug — API حوالہ کے لیے دستاویزی ساخت، خودکار ٹیسٹ اور یقینی طور پر مشاہدہ شدہ لائیو رویے کے درمیان واضح فرق کرنا ضروری ہے۔
تصدیقِ شناخت اور تحفظ
تصدیقِ شناخت ضروری نہیں
Idempotent (دہرانے پر یکساں اثر): جی ہاں
پیرامیٹرز
slug(path, string، ضروری)— 'impressum' | 'datenschutz' | 'agb'مثالی Response
{"ok":true,"data":{"body_html":"<h2>§ 5 DDG کے مطابق تفصیلات</h2>...","updated_at":"2026-07-19T...","version":5}}خرابی کے کوڈز
404 LEGAL_SLUG_UNKNOWN — نامعلوم لیگل اسلگ۔لائیو ٹیسٹ کا ثبوت
کامیابی (200، اصل مواد) اور منفی صورت (404) پروڈکشن کے خلاف لائیو تصدیق شدہ۔