עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
prop=videoinfo (vi)
- יחידה זו דורשת הרשאות קריאה.
- מקור: TimedMediaHandler
- רישיון: GPL-2.0-or-later
הרחבת מידע על תמונה (imageinfo) שיכלול את המידע על מקור הווידאו (נגזרים)
- viprop
איזה מידע על הקובץ לקבל:
- timestamp
- הוספת חותם־זמן לגרסה שהועלתה.
- user
- הוספה המשתמש שהעלה כל גרסה של קובץ.
- userid
- הוספת מזהה המשתמש שהעלה כל גרסה של קובץ.
- comment
- תגובה על הגרסה.
- parsedcomment
- פענוח ההערה על גרסה.
- canonicaltitle
- הוספת הכותרת הקנונית של הקובץ.
- url
- מתן URL לקובץ ולדף התיאור.
- size
- הוספת הגודל של הקובץ בבייטים והגובה, הרוחב ומניין הדפים (אם זה מתאים).
- dimensions
- כינוי ל־size.
- sha1
- הוספת גיבוב SHA-1 עבור הקובץ.
- mime
- הוספת סוג ה־MIME של הקובץ.
- thumbmime
- הוספת סוג ה־MIME של התמונה הממוזערת (נדרש url והפרמטר viurlwidth).
- mediatype
- הוספת סוג המדיה של הקובץ.
- metadata
- טעינת מטא־נתונים של Exif עבור גרסת הקובץ.
- commonmetadata
- רשימת מטא־נתונים כלליים על תסדיר הקובץ עבור גרסת הקובץ.
- extmetadata
- רשימת מטא־נתונים מעוצבים משולבים ממספר מקורות. התוצאה מעוצבת ב־HTML.
- archivename
- הוספת שם הקובץ של גרסת הארכיון עבור הגרסאות שאינן האחרונה.
- bitdepth
- הוספת עומק הביטים של הגרסה.
- uploadwarning
- משמש את Special:Upload כדי לקבל מידע על קובץ קיים. לא נועד לשימוש מחוץ לליבת MediaWiki.
- badfile
- מוסיף האם הקובץ נמצא ב־MediaWiki:Bad image list
- derivatives
- הוספת מערך של הגרסאות הזמינות בתסדירים אחרים ובאיכויות אחרות של קובץ הווידאו או האודיו.
- timedtext
- הוספת מערך תת־כותרות, כיתובים ותיאורים של קובצי שמע ווידאו שזמינים.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning, badfile, derivatives, timedtext
- ברירת מחדל: timestamp|user
- vilimit
כמה גרסאות של קובץ לכל קובץ.
- המספר המרבי המותר הוא 500 (עבור בוטים – 5,000).
- סוג: מספר שלם או max
- ברירת מחדל: 1
- vistart
מאילו תאריך ושעה להתחיל את הרשימה.
- סוג: חותם־זמן (תסדירים מורשים)
- viend
באיזה חותם־זמן לסיים את הרשימה.
- סוג: חותם־זמן (תסדירים מורשים)
- viurlwidth
אם מוגדר viprop=url, יוחזר URL לתמונה שגודלה הותאם לרוחב הזה. מסיבות של ביצועים, אם האפשרות הזאת משמשת, לא יוחזרו יותר מ־50 תמונות.
- סוג: מספר שלם
- ברירת מחדל: -1
- viurlheight
דומה ל־viurlwidth.
- סוג: מספר שלם
- ברירת מחדל: -1
- vimetadataversion
גרסת המטא־נתונים לשימוש. אם מוגדר latest, להשתמש בגרסה החדשה ביותר. בררת המחדל היא 1 לצורך תאימות אחורה.
- ברירת מחדל: 1
- viextmetadatalanguage
באיזו שפה לאחזר את המטא־נתונים. זה משפיע על אילו תרגומים לאחזר, האם יש כמה, וגם איך דברים כמו מספרים וערכים שונים מעוצבים.
- ברירת מחדל: he
- viextmetadatamultilang
אם תרגומים של המאפיין extmetadata זמינים, לאחזר את כולם.
- סוג: בוליאני (פרטים)
- viextmetadatafilter
אם זה מוגדר ולא ריק, רק המפתחות האלה יוחזרו עבור viprop=extmetadata.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- viurlparam
מחרוזת פרמטר ייחודית למטפל. למשל, PDF־ים יכולים להשתמש ב־page15-100px. viurlwidth צריך לשמש ולהיות עקבי עם viurlparam.
- ברירת מחדל: (ריק)
- vibadfilecontexttitle
אם badfilecontexttitleprop=badfile מוגדר, זאת כותרת הדף שתשמש בזמן שערוך ה־MediaWiki:Bad image list
- vicontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- vilocalonly
חיפוש אחר קבצים במאגר המקומי בלבד.