עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API

list=categorymembers (cm)

(main | query | categorymembers)
  • יחידה זו דורשת הרשאות קריאה.
  • אפשר להשתמש ביחידה הזאת בתור מחולל.
  • מקור: MediaWiki
  • רישיון: GPL-2.0+

רשימת כל הדפים בקטגוריה נתונה.

פרמטרים:
cmtitle

איזו קטגוריה למנות (נדרש). חייב לכלול את התחילית קטגוריה:. לא יכול לשמש יחד עם cmpageid.

cmpageid

מזהה הדף של הקטגוריה שצריך למנות. לא יכול לשמש יחד עם cmtitle.

סוג: מספר שלם
cmprop

אילו חלקי מידע לכלול:

ids
הוספת מזהה הדף.
title
הוספת השם ומזהה מרחב השם של הדף.
sortkey
הוספת מפתח המיון שמשמש למיון בקטגוריה (מחרזות הקסדצימלית).
sortkeyprefix
הוספת מפתח המיון שמשמש למיון בקטגוריה (מחרוזת הקסדצימלית).
type
הוספת הסוג שהדף מוין אליו (דף, תת־קטגוריה, או קובץ).
timestamp
הוספת חותם־הזמן שבו הדף נכלל.
ערכים (מופרדים באמצעות "|"): ids, title, sortkey, sortkeyprefix, type, timestamp
ברירת מחדל: ids|title
cmnamespace

לכלול רק דפים במרחבי השם האלה. יש לשים לב לכך ש־cmtype=subcat או cmtype=file יכולים לשמש במקום cmnamespace=14 או 6.

ערכים (מופרדים באמצעות "|"): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
cmtype

איזה סוג של חברי קטגוריה לכלול. לא תקף כאשר מוגדר cmsort=timestamp.

ערכים (מופרדים באמצעות "|"): page, subcat, file
ברירת מחדל: page|subcat|file
cmcontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.

cmlimit

מספר הדפים המרבי שיוחזר.

המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
סוג: מספר שלם או max
ברירת מחדל: 10
cmsort

לפי איזה מאפיין למיין.

אחד מהערכים הבאים: sortkey, timestamp
ברירת מחדל: sortkey
cmdir

באיזה כיוון למיין.

אחד מהערכים הבאים: asc, desc, ascending, descending, newer, older
ברירת מחדל: ascending
cmstart

מאיזה חותם־זמן להתחיל לרשום. יכול לשמש רק עם cmsort=timestamp.

סוג: חותם־זמן (תסדירים מורשים)
cmend

באיזה חותם־זמן לסיים לרשום. יכול לשמש רק עם cmsort=timestamp.

סוג: חותם־זמן (תסדירים מורשים)
cmstarthexsortkey

מפתח מיון להתחיל לרשום ממנו, כפי שמוחזר על־ידי cmprop=sortkey</kbd. יכול לשמש רק עם cmsort=sortkey.

cmendhexsortkey

מפתח מיון לסיים לרשום ממנו, כפי שמוחזר על־ידי cmprop=sortkey. יכול לשמש רק עם cmsort=sortkey.

cmstartsortkeyprefix

תחילית מפתח מיון להתחיל לרשום ממנה. יכול לשמש רק עם cmsort=sortkey. דורס את cmstarthexsortkey.

cmendsortkeyprefix

תחילית מפתח מיון שהרשימה תסתיים לפניה (לא בה, אם הערך הזה מוגדר, הוא לא ייכלל!). יכול לשמש רק עם cmsort=sortkey. דורס את cmendhexsortkey.

cmstartsortkey
מיושן.

כדאי להשתמש ב־cmstarthexsortkey במקום.

cmendsortkey
מיושן.

כדאי להשתמש ב־cmendhexsortkey במקום.

דוגמאות:
קבלת עשרת העמודים הראשונים שתחת קטגוריה:פיזיקה.
api.php?action=query&list=categorymembers&cmtitle=Category:Physics
קבל מידע על הדף עבור 10 הדפים הראשונים ב־Category:Physics.
api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info