עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=categorymembers (cm)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: 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 [פתיחה בארגז חול]