עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=watch
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
להוסיף דפים לרשימת המעקב של המשתמש הנוכחי או להסיר אותם ממנה.
- title
- מיושן.
הדף להוסיף לרשימת המעקב או להסיר ממנה. יש להשתמש במקום זאת ב־titles.
- expiry
חותם־זמן שיחול על כל הדפים הנתונים. יש להשמיט את הפרמטר הזה לגמרי כדי להשאיר תפוגות נוכחיות ללא שינוי.
- סוג: תפוגה (פרטים)
- unwatch
אם זה מוגדר, הדף יהיה לא במעקב במקום להיות במעקב.
- סוג: בוליאני (פרטים)
- continue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
- titles
רשימת כותרות.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- pageids
רשימת מזהי דף לעבוד עליהם.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- revids
רשימת מזהי גרסה לעבוד עליהם. נא לשים לב לכך שכמעט כל מודולי ה־query ימירו מזהי גרסאות למזהה הדף המתאים ויעבדו במקום זאת על הגרסה האחרונה. רק prop=revisions משתמש בגרסאות מדויקות לתגובה.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- generator
קבלת רשימת דפים לעבוד עליהם על־ידי הרצת יחידת ה־query שצוינה.
לתשומת ליבך: לשמות בפרמטר generator צריכה להיות התחילית "g", ר' דוגמאות.
- allcategories
- למנות את כל הקטגוריות.
- alldeletedrevisions
- רשימת כל הגרסאות המחוקות על־ידי משתמש או במרחב.
- allfileusages
- לרשום את כל שימושי הקובץ, כולל בלתי־קיימים.
- allimages
- למנות את כל התמונות לפי הסדר.
- alllinks
- למנות את כל הקישורים שמצביעים למרחב שם נתון.
- allpages
- למנות את כל הדפים לפי הסדר במרחב שם נתון.
- allredirects
- רשימה של כל ההפניות למרחב שם.
- allrevisions
- רשימת כל הגרסאות.
- alltransclusions
- רשימת כל ההכללות (דפים שמוטבעים באמצעות {{x}}), כולל כאלה שאינם קיימים.
- backlinks
- מציאת כל הדפים שמקשרים לדף הנתון.
- categories
- לרשום את כל הקטגוריות שהדף שייך אליהן.
- categorymembers
- רשימת כל הדפים בקטגוריה נתונה.
- deletedrevisions
- קבלת מידע על גרסה מחוקה.
- duplicatefiles
- רשימת כל הקבצים שהם כפולים של קבצים נתונים לפי ערכי הגיבוב.
- embeddedin
- חיפוש כל הדפים שמטביעים (מכלילים) את הכותרת הנתונה.
- exturlusage
- למנות דפים שמכילים URL נתון.
- fileusage
- מציאת כל הדפים שמשתמשים בקבצים הנתונים.
- geosearch
- החזרת דפים שיש להם נקודות ציון שנמצאות באזור מסוים.
- images
- להחזיר את כל הקבצים שמכילים הדפים הנתונים.
- imageusage
- מציאת כל הדפים שמתמשים בשם התמונה הנתונה.
- iwbacklinks
- מציאות כל הדפים שמקשרים לקישור הבינוויקי הנתון.
- langbacklinks
- מציאת כל הדפים שמקשרים לקישור השפה הנתון.
- links
- החזרת כל הקישורים מהדפים שצוינו.
- linkshere
- מציאת כל הדפים שמקשרים לדפים הנתונים.
- mostviewed
- רשימת הדפים הנצפים ביותר (על סמך ספירת הצפיות בדפים ביום האחרון).
- pageswithprop
- לרשום את כל הדפים שמשתמשים במאפיין דף נתון.
- prefixsearch
- ביצוע חיפוש תחילית של כותרות דפים.
- protectedtitles
- לרשום את כל הכותרות שמוגנות מפני יצירה.
- querypage
- קבלת רשימה שמסופקת על־ידי דף מיוחד מבוסס־QueryPage.
- random
- קבלת ערכת דפים אקראיים.
- recentchanges
- למנות שינויים אחרונים.
- redirects
- מחזיר את כל ההפניות לדפים הנתונים.
- revisions
- קבלת מידע על גרסה.
- search
- ביצוע חיפוש בכל הטקסט.
- templates
- החזרת כל הדפים המוכללים בדפים הנתונים.
- transcludedin
- מציאת כל הדפים שמכלילים את הדפים הנתונים.
- watchlist
- קבלת שינויים אחרונים לדפים ברשימת המעקב של המשתמש הנוכחי.
- watchlistraw
- קבלת כל הדפים ברשימת המעקב של המשתמש הנוכחי.
- wblistentityusage
- החזרת כל הדפים שמשתמשים במזהי הישות הנתונים.
- readinglistentries
- פנימי. קבלת רשימת הדפים מרשימה מסוימת.
- אחד מהערכים הבאים: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, geosearch, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, mostviewed, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw, wblistentityusage, readinglistentries
- redirects
פתרון אוטומטי של הפניות ב־titles, ב־pageids, וב־revids, ובדפים שמחזיר generator.
- סוג: בוליאני (פרטים)
- converttitles
המרת כותרות לסוגי כתב אחרים אם זה נחוץ. זה עובד רק אם שפת הכותרת של הוויקי תומכת בהמרת סוגי כתב. השפות שתומכות בהמרת סוגי כתב הן ban, en, crh, gan, iu, ku, mni, sh, shi, sr, tg, tly, uz, wuu, zgh וגם zh.
- סוג: בוליאני (פרטים)
- token
אסימון "watch" שאוחזר מ־action=query&meta=tokens
- הפרמטר הזה נדרש.
- לעקוב אחרי הדף עמוד ראשי.
- api.php?action=watch&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&token=123ABC [פתיחה בארגז חול]
- לעקוב אחר הדפים עמוד ראשי, Foo, ו־Bar למשך חודש.
- api.php?action=watch&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99|Foo|Bar&expiry=1%20month&token=123ABC [פתיחה בארגז חול]
- להפסיק את המעקב אחר הדף עמוד ראשי.
- api.php?action=watch&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99&unwatch=&token=123ABC [פתיחה בארגז חול]
- לעקוב אחרי הדפים הראשונים במרחב הראשי.
- api.php?action=watch&generator=allpages&gapnamespace=0&token=123ABC [פתיחה בארגז חול]