עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=allimages (ai)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
למנות את כל התמונות לפי הסדר.
- aisort
לפי איזה מאפיין למיין.
- אחד מהערכים הבאים: name, timestamp
- ברירת מחדל: name
- aidir
באיזה כיוון לרשום.
- אחד מהערכים הבאים: ascending, descending, newer, older
- ברירת מחדל: ascending
- aifrom
מאיזה שם תמונה להתחיל למנות. יכול לשמש רק עם aisort=name.
- aito
כותרת תמונה שבה תסתיים המניי. יכול לשמש רק עם aisort=name.
- aicontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- aistart
מאיזה חותם־זמן להתחיל למנות. יכול לשמש רק עם aisort=timestamp.
- סוג: חותם־זמן (תסדירים מורשים)
- aiend
באיזה חותם זמן להפסיק לרשום. אפשר להשתמש בזה רק עם aisort=timestamp.
- סוג: חותם־זמן (תסדירים מורשים)
- aiprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- user
- הוספה המשתמש שהעלה כל גרסה של קובץ.
- userid
- הוספת מזהה המשתמש שהעלה כל גרסה של קובץ.
- comment
- תגובה על הגרסה.
- parsedcomment
- פענוח ההערה על גרסה.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ.
- url
- מתן URL לקובץ ולדף התיאור.
- size
- הוספת הגודל של הקובץ בבתים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ.
- mime
- הוספת סוג ה־MIME של הקובץ.
- mediatype
- הוספת סוג המדיה של הקובץ.
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML.
- bitdepth
- הוספת עומק הביטים של הגרסה.
- ערכים (מופרדים באמצעות "|"): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, mediatype, metadata, commonmetadata, extmetadata, bitdepth
- ברירת מחדל: timestamp|url
- aiprefix
חיפוש כל שמות התמונות שמתחילים בערך הזה. יכול לשמש רק עם aisort=name.
- aiminsize
להגביל לתמונות עם מספר כזה של בתים לפחות.
- סוג: מספר שלם
- aimaxsize
להגביל לתמונות עם מספר כזה לכל היותר של בתים.
- סוג: מספר שלם
- aisha1
גיבוב SHA1 של תמונה. דריסת aisha1base36.
- aisha1base36
גיבוב SHA1 של התמונה בבסיס 36 (הבסיס בו נעשה שימוש במדיה־ויקי).
- aiuser
להחזיר רק קבצים שהועלו על־ידי המשתמש הזה. יכול לשמש רק עם aisort=timestamp. לא יכול לשמש יחד עם aifilterbots.
- סוג: שם משתמש
- aifilterbots
איך לסנן קבצים שמעלים בוטים. יכול לשמש רק עם aisort=timestamp. לא יכול לשמש יחד עם aiuser.
- אחד מהערכים הבאים: all, bots, nobots
- ברירת מחדל: all
- aimime
אילו סוגי MIME לחבפש, למשל image/jpeg.
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- ailimit
כמה תמונות להחזיר בסך הכול.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- הצגת רשימה של קבצים שמתחילים באות B.
- api.php?action=query&list=allimages&aifrom=B
- הצגת רשימת קבצים שהועלו לאחרונה, דומה ל־Special:NewFiles.
- api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older
- להציג רשימה של קבצות שסוג ה־MIME שלהם הוא image/png או image/png.
- api.php?action=query&list=allimages&aimime=image/png|image/gif
- הצגת מידע על 4 קבצים המתחילים באות T.
- api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo