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