עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=imageinfo (ii)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
החזרת מידע על קובץ והיסטורייה העלאה.
- iiprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- user
- הוספה המשתמש שהעלה כל גרסה של קובץ.
- userid
- הוספת מזהה המשתמש שהעלה כל גרסה של קובץ.
- comment
- תגובה על הגרסה.
- parsedcomment
- פענוח ההערה על גרסה.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ.
- url
- מתן URL לקובץ ולדף התיאור.
- size
- הוספת הגודל של הקובץ בבייטים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ.
- mime
- הוספת סוג ה־MIME של הקובץ.
- thumbmime
- הוספת סוג ה־MIME של התמונה הממוזערת (נדרש url והפרמטר iiurlwidth).
- mediatype
- הוספת סוג המדיה של הקובץ.
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML.
- archivename
- הוספת שם הקובץ של גרסת הארכיון עבור הגרסאות שאינן האחרונה.
- bitdepth
- הוספת עומק הביטים של הגרסה.
- uploadwarning
- משמש את Special:Upload כדי לקבל מידע על קובץ קיים. לא נועד לשימוש מחוץ לליבת MediaWiki.
- badfile
- מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
- ערכים (מופרדים באמצעות "|" או or תו חלופי): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning, badfile
- ברירת מחדל: timestamp|user
- iilimit
כמה גרסאות של קובץ לכל קובץ.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 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 [פתיחה בארגז חול]