עזרה של MediaWiki API

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

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

list=allimages (ai)

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

למנות את כל התמונות לפי הסדר.

פרמטרים:
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
הוספה המשתמש שהעלה כל גרסה של קובץ. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
userid
הוספת מזהה המשתמש שהעלה כל גרסה של קובץ. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
comment
תקציר על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
parsedcomment
פענוח ההערה על גרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
canonicaltitle
הוספת הכותרת הקנונית של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
url
מתן URL לקובץ ולדף התיאור. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
size
הוספת הגודל של הקובץ בבייטים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
dimensions
כינוי ל־size.
sha1
הוספת גיבוב SHA-1 עבור הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
mime
הוספת סוג ה־MIME של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
mediatype
הוספת סוג המדיה של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
metadata
טעינת מטא־נתונים של Exif עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
commonmetadata
רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
extmetadata
רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
bitdepth
הוספת עומק הביטים של הגרסה. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
badfile
מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
ערכים (מופרדים באמצעות "|" או or תו חלופי): badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, timestamp, url, user, userid
ברירת המחדל: timestamp|url
aiprefix

חיפוש כל שמות התמונות שמתחילים בערך הזה. יכול לשמש רק עם aisort=name.

aiminsize

להגביל לתמונות עם מספר כזה של בייטים לפחות.

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

להגביל לתמונות עם מספר כזה לכל היותר של בייטים.

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

גיבוב SHA1 של תמונה. דריסת aisha1base36.

aisha1base36

גיבוב SHA1 של התמונה בבסיס 36 (הבסיס בו נעשה שימוש במדיה־ויקי).

aiuser

להחזיר רק קבצים שהועלו על־ידי המשתמש הזה. יכול לשמש רק עם aisort=timestamp. לא יכול לשמש יחד עם aifilterbots.

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")
aifilterbots

איך לסנן קבצים שמעלים בוטים. יכול לשמש רק עם aisort=timestamp. לא יכול לשמש יחד עם aiuser.

אחד מהערכים הבאים: all, bots, nobots
ברירת המחדל: all
aimime

אילו סוגי MIME לחפש, למשל image/jpeg.

הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
ailimit

כמה תמונות להחזיר בסך הכול.

סוג: מספר שלם או max
הערך חייב להיות בין 1 ל־500.
ברירת המחדל: 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/gif.
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 [פתיחה בארגז חול]