עזרה של MediaWiki API

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

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

list=categorymembers (cm)

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

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

פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
cmtitle

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

cmpageid

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

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

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

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

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

לתשומת ליבך: בשל מצב חיסכון, שימוש בזה יכול להוביל לפחות מ־cmlimit תוצאות לפני המשך; במצבים קיצוניים ייתכן שיחזרו אפס תוצאות.

ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 108, 109, 110, 111, 710, 711, 828, 829
כדי לתת את כל הערכים, יש להשתמש ב־*.
cmtype

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

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

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.

cmlimit

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

סוג: מספר שלם או max
הערך חייב להיות בין 1 ל־500.
ברירת המחדל: 10
cmsort

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

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

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

אחד מהערכים הבאים: asc, ascending, desc, 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 במקום.

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