עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=stashimageinfo (sii)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
החזרת מידע על הקובץ עבור הקבצים המוסלקים.
פרמטרים:
- siifilekey
מפתח שמזהה העלאה קודמת שהוסלקה באופן זמני.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- siisessionkey
- מיושן.
כינוי ל־siifilekey, לתאימות אחורה.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- siiprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- url
- מתן URL לקובץ ולדף התיאור. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- size
- הוספת הגודל של הקובץ בבתים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- mime
- הוספת סוג ה־MIME של הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- thumbmime
- הוספת סוג ה־MIME של התמונה הממוזערת (נדרש url והפרמטר siiurlwidth). אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים מכמה מקורות. התוצאה מעוצבת ב־HTML. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- bitdepth
- הוספת עומק הביטים של הגרסה. אם הקובץ נמחק במחיקת גרסאות, יוחזר המאפיין filehidden.
- badfile
- מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
- ערכים (מופרדים באמצעות "|" או or תו חלופי): badfile, bitdepth, canonicaltitle, commonmetadata, dimensions, extmetadata, metadata, mime, sha1, size, thumbmime, timestamp, url
- ברירת המחדל: 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 [פתיחה בארגז חול]