עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=allfileusages (af)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
לרשום את כל שימושי הקובץ, כולל בלתי־קיימים.
פרמטרים:
- afcontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- affrom
מאיזה שם קובץ להתחיל למנות.
- afto
שם הקובץ שהמנייה תסתיים בו.
- afprefix
חיפוש כל שמות הקבצים שמתחילים עם הערך הזה.
- afunique
להציג רק שמות קבצים ייחודיים. לא יכול לשמש עם afprop=ids. בעת שימוש בתור מחולל, נותן דפי יעד במקום דפי מקור.
- סוג: בוליאני (פרטים)
- afprop
אילו חלקי מידע לכלול:
- ids
- הוספת מזהי הדף של הדפים המשתמשים (לא יכול לשמש עם afunique).
- title
- הוספת שם הקובץ.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): ids, title
- ברירת מחדל: title
- aflimit
כמה פריטים להחזיר בסך הכול.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- afdir
באיזה כיוון לרשום.
- אחד מהערכים הבאים: ascending, descending
- ברירת מחדל: ascending
דוגמאות:
- רשימת שמות קבצים, כולל חסרים, עם מזהי הדפים שהם מופיעים בהם, החל מ־B.
- api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title [פתיחה בארגז חול]
- רשימת שמות קבצים ייחודיים.
- api.php?action=query&list=allfileusages&afunique=&affrom=B [פתיחה בארגז חול]
- קבלת כל שמות הקבצים, כולל חסרים.
- api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B [פתיחה בארגז חול]
- קבלת דפים שמכילים את הקבצים.
- api.php?action=query&generator=allfileusages&gaffrom=B [פתיחה בארגז חול]