עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=imageinfo (ii)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
החזרת מידע על קובץ והיסטורייה העלאה.
- iiprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- user
- הוספה המשתמש שהעלה כל גרסה של קובץ. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- userid
- הוספת מזהה המשתמש שהעלה כל גרסה של קובץ. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
- comment
- תקציר על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- parsedcomment
- פענוח ההערה על גרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- url
- מתן URL לקובץ ולדף התיאור. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- size
- הוספת הגודל של הקובץ בבייטים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- mime
- הוספת סוג ה־MIME של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- thumbmime
- הוספת סוג ה־MIME של התמונה הממוזערת (נדרש url והפרמטר iiurlwidth). אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- mediatype
- הוספת סוג המדיה של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- archivename
- הוספת שם הקובץ של גרסת הארכיון עבור הגרסאות שאינן האחרונה. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- bitdepth
- הוספת עומק הביטים של הגרסה. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- uploadwarning
- משמש את Special:Upload כדי לקבל מידע על קובץ קיים. לא נועד לשימוש מחוץ לליבת MediaWiki.
- badfile
- מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
- ערכים (מופרדים באמצעות "|" או or תו חלופי): archivename, badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, thumbmime, timestamp, uploadwarning, url, user, userid
- ברירת המחדל: timestamp|user
- iilimit
כמה גרסאות של קובץ לכל קובץ.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 1
- iistart
מאילו תאריך ושעה להתחיל את הרשימה.
- סוג: חותם־זמן (תסדירים מורשים)
- iiend
באיזה חותם־זמן לסיים את הרשימה.
- סוג: חותם־זמן (תסדירים מורשים)
- iiurlwidth
אם מוגדר iiprop=url, יוחזר URL לתמונה שגודלה הותאם לרוחב הזה. מסיבות של ביצועים, אם האפשרות הזאת משמשת, לא יוחזרו יותר מ־50 תמונות.
- סוג: מספר שלם
- ברירת המחדל: -1
- iiurlheight
דומה ל־iiurlwidth.
- סוג: מספר שלם
- ברירת המחדל: -1
- iimetadataversion
גרסת המטא־נתונים לשימוש. אם מוגדר latest, להשתמש בגרסה החדשה ביותר. ברירת המחדל היא 1 לצורך תאימות אחורה.
- ברירת המחדל: 1
- iiextmetadatalanguage
באיזו שפה לאחזר את המטא־נתונים. זה משפיע על אילו תרגומים לאחזר, האם יש כמה, וגם איך דברים כמו מספרים וערכים שונים מעוצבים.
- ברירת המחדל: he
- iiextmetadatamultilang
אם תרגומים של המאפיין extmetadata זמינים, לאחזר את כולם.
- סוג: בוליאני (פרטים)
- iiextmetadatafilter
אם זה מוגדר ולא ריק, רק המפתחות האלה יוחזרו עבור iiprop=extmetadata.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- iiurlparam
מחרוזת פרמטר ייחודית למטפל. למשל, PDF־ים יכולים להשתמש ב־page15-100px. iiurlwidth צריך לשמש ולהיות עקבי עם iiurlparam.
- ברירת מחדל: (ריק)
- iibadfilecontexttitle
אם badfilecontexttitleprop=badfile מוגדר, זאת כותרת הדף שתשמש בזמן שערוך ה־MediaWiki:Bad image list
- iicontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- iilocalonly
חיפוש אחר קבצים במאגר המקומי בלבד.
- סוג: בוליאני (פרטים)
- קבלת מידע על הגרסה הנוכחית של File:Albert Einstein Head.jpg.
- api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [פתיחה בארגז חול]
- אחזור מידע על גרסאות של File:Test.jpg מ־2008 ואחרי־כן.
- api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [פתיחה בארגז חול]
![[פתיחה בארגז חול]](/index.php/%D7%9E%D7%99%D7%95%D7%97%D7%93:%D7%90%D7%A8%D7%92%D7%96_%D7%97%D7%95%D7%9C_%D7%A9%D7%9C_API#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[פתיחה בארגז חול]](/index.php/%D7%9E%D7%99%D7%95%D7%97%D7%93:%D7%90%D7%A8%D7%92%D7%96_%D7%97%D7%95%D7%9C_%D7%A9%D7%9C_API#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}