עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=categories (cl)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
לרשום את כל הקטגוריות שהדף שייך אליהן.
פרמטרים:
- clprop
אילו מאפיינים נוספים לקבל עבור כל קטגוריה:
- sortkey
- הוספת מפתח מיון (מחרוזת הקסדצימלית) ותחילית מפתח מיון (החלק הקריא) עבור קטגוריה.
- timestamp
- הוספת חותם־הזמן של יצירת הקטגוריה.
- hidden
- תיוג קטגוריות שהוסתרו באמצעות
__HIDDENCAT__.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): sortkey, timestamp, hidden
- clshow
איזה סוג של קטגוריות להציג.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): hidden, !hidden
- cllimit
כמה קטגוריות להחזיר.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- clcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- clcategories
לרשום רק את הקטגוריות האלו. שימושי לבדיקה אם דף מסוים נמצא בקטגוריה מסוימת.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- cldir
באיזה כיוון לרשום.
- אחד מהערכים הבאים: ascending, descending
- ברירת מחדל: ascending
דוגמאות:
- קבלת רשימת קטגוריות שהם Albert Einstein שייך אליהן.
- api.php?action=query&prop=categories&titles=Albert%20Einstein [פתיחה בארגז חול]
- קבלת מידע על כל הקטגוריות שמשמשות בדף Albert Einstein.
- api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info [פתיחה בארגז חול]