עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=stashimageinfo (sii)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0+
החזרת מידע על הקובץ עבור הקבצים המוסלקים.
פרמטרים:
- siifilekey
מפתח שמזהה העלאה קודמת שהוסלקה באופן זמני.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- siisessionkey
- מיושן.
כינוי ל־siifilekey, לתאימות אחורה.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- siiprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ.
- url
- מתן URL לקובץ ולדף התיאור.
- size
- הוספת הגודל של הקובץ בבייטים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ.
- mime
- הוספת סוג ה־MIME של הקובץ.
- thumbmime
- הוספת סוג ה־MIME של התמונה הממוזערת (נדרש url והפרמטר siiurlwidth).
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML.
- bitdepth
- הוספת עומק הביטים של הגרסה.
- badfile
- מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
- ערכים (מופרדים באמצעות "|" או or תו חלופי): timestamp, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, metadata, commonmetadata, extmetadata, bitdepth, badfile
- ברירת מחדל: timestamp|url
- siiurlwidth
אם מוגדר siiprop=url, יוחזר URL לתמונה שגודלה הותאם לרוחב הזה. מסיבות של ביצועים, אם האפשרות הזאת משמשת, לא יוחזרו יותר מ־50 תמונות.
- סוג: מספר שלם
- ברירת מחדל: -1
- siiurlheight
דומה ל־siiurlwidth.
- סוג: מספר שלם
- ברירת מחדל: -1
- siiurlparam
מחרוזת פרמטר ייחודית למטפל. למשל, PDF־ים יכולים להשתמש ב־page15-100px. siiurlwidth צריך לשמש ולהיות עקבי עם siiurlparam.
- ברירת מחדל: (ריק)
דוגמאות:
- החזרת מידע על קובץ מוסלק.
- api.php?action=query&prop=stashimageinfo&siifilekey=124sd34rsdf567 [פתיחה בארגז חול]
- החזרת תמונות ממוזערות עבור שני קבצים מוסלקים.
- api.php?action=query&prop=stashimageinfo&siifilekey=b34edoe3|bceffd4&siiurlwidth=120&siiprop=url [פתיחה בארגז חול]