GET/api/public/legal/:slug
מחזיר טקסט משפטי בודד כ-HTML.
העמוד "GET /api/public/legal/:slug — API-Reference" עוסק בתחום הפונקציונלי המצוין ב-URL. התוכן הקיים משולב בתיאור התהליך בפועל, הדרישות המוקדמות והמגבלות הידועות. ל-Zentor אין מערכת מפתחות API למפתחים. לדשבורד משתמשים ב-JWTs של סשן עם תוקף של 12 שעות ובטוקנים לרענון (Refresh-Tokens) עם תוקף של 7 ימים; TOTP ו-SSO הם אופציונליים. טוקני הטמעת וידג'טים (Widget-Embed-Tokens) מוצגים פעם אחת בטקסט רגיל (Plaintext) וקשורים ל-Origin מאושרים. התיעוד של `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 בסביבת ייצור, טוקני סשן וחותמות זמן ספציפיות אינם שייכים לדוגמאות ציבוריות. רף המגבלה הידוע ברחבי הפלטפורמה הוא 2,000 בקשות בתוך 15 דקות; מגבלה יחידה סוטה אינה מאומתת. קריאות POST שאינן אידימפוטנטיות (Idempotent) לא צריכות לחזור על עצמן באופן עיוור לאחר קריסה ברשת לא ברורה. שגיאות אינטגרציה נפוצות עבור נתיב זה נובעות מפעולות חובה חסרות, סוגי נתונים שגויים, קודים חד-פעמיים שפג תוקפם, Origins לא מורשים או רשומת נתונים שלא יושמה. היישום צריך לטפל במקרים אלו בנפרד ולתעד את הודעת השגיאה המוחזרת על ידי נקודת הקצה, מבלי לכתוב תוכן חסוי. בקשה מוצלחת מאשרת רק שלב עיבוד זה, ולא בהכרח הצלחה של אימייל, תשלום או SSO המצורפים לאחר מכן. זה רלוונטי מידית ל-"GET /api/public/legal/:slug — API-Reference". הבדיקה הטכנית של עמוד זה חייבת להסתמך על הרישום ב-`app/frontend/src/content/api-reference/` ועל נתיבי ה-Backend הרלוונטיים. הערות בדיקה חיות (Live-Test) יכולות לטעון רק את מה שנבדק בפועל. בדיקה שלילית (Negative Test) או אנלוגיה בקוד אינם הוכחה מלאה להצלחה. לכן, עבור "GET /api/public/legal/:slug — API-Reference", יש להבחין בבירור בין המבנה המתועד, הבדיקה האוטומטית וההתנהגות החיה שנצפתה בבטחה.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Ja
Parameter
slug(path, string, erforderlich)— 'אימפרסום' | 'מדיניות פרטיות' | 'תנאי שימוש'Beispiel-Response
{"ok":true,"data":{"body_html":"<h2>פרטים לפי סעיף 5 DDG</h2>...","updated_at":"2026-07-19T...","version":5}}Fehlercodes
404 LEGAL_SLUG_UNKNOWN — שם משפטי לא ידוע.Live-Test-Nachweis
הצלחה (200, תוכן אמיתי) ומקרה שלילי (404) אומתו בחיים מול ייצור.