עזרה של MediaWiki API

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

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

list=allimages (ai)

(main | query | allimages)
  • יחידה זו דורשת הרשאות קריאה.
  • אפשר להשתמש ביחידה הזאת בתור מחולל.
  • מקור: 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