עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=categories (cl)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
לרשום את כל הקטגוריות שהדף שייך אליהן.
פרמטרים:
- clprop
אילו מאפיינים נוספים לקבל עבור כל קטגוריה:
- sortkey
- הוספת מפתח מיון (מחרוזת הקסדצימלית) ותחילית מפתח מיון (החלק הקריא) עבור קטגוריה.
- timestamp
- הוספת חותם־הזמן של יצירת הקטגוריה.
- hidden
- תיוג קטגוריות שהוסתרו באמצעות
__HIDDENCAT__.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): hidden, sortkey, timestamp
- clshow
איזה סוג של קטגוריות להציג.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): !hidden, hidden
- cllimit
כמה קטגוריות להחזיר.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 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 [פתיחה בארגז חול]