עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API

action=watch

(main | watch)
  • יחידה זו דורשת הרשאות קריאה.
  • היחידה הזאת דורשת הרשאות כתיבה.
  • יחידה זו מקבלת רק בקשות POST.
  • מקור: MediaWiki
  • רישיון: GPL-2.0-or-later

להוסיף דפים לרשימת המעקב של המשתמש הנוכחי או הסרתם ממנה.

פרמטרים:
title
מיושן.

הדף להוסיף לרשימת המעקב או להסיר ממנה. יש להשתמש במקום זאת ב־titles.

unwatch

אם זה מוגדר, הדף יהיה לא במעקב במקום להיות במעקב.

סוג: בוליאני (פרטים)
continue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.

titles

רשימת כותרות.

הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
pageids

רשימת מזהי דף לעבוד עליהם.

סוג: רשימת מספרים שלמים
הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
revids

רשימת מזהי גרסה לעבוד עליהם.

סוג: רשימת מספרים שלמים
הפרדה בין ערכים נעשית באמצעות | או תו חלופי. מספר הערכים המרבי הוא 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
מציאת כל הדפים שמשתמשים בקבצים הנתונים.
images
להחזיר את כל הקבצים שמכילים הדפים הנתונים.
imageusage
מציאת כל הדפים שמתמשים בשם התמונה הנתונה.
iwbacklinks
מציאות כל הדפים שמקשרים לקישור הבינוויקי הנתון.
langbacklinks
מציאת כל הדפים שמקשרים לקישור השפה הנתון.
links
החזרת כל הקישורים מהדפים שצוינו.
linkshere
מציאת כל הדפים שמקשרים לדפים הנתונים.
pageswithprop
לרשום את כל הדפים שמשתמשים במאפיין דף נתון.
prefixsearch
ביצוע חיפוש תחילית של כותרות דפים.
protectedtitles
לרשום את כל הכותרות שמוגנות מפני יצירה.
querypage
קבלת רשימה שמסופקת על־ידי דף מיוחד מבוסס־QueryPage.
random
קבלת ערכת דפים אקראיים.
recentchanges
למנות שינויים אחרונים.
redirects
מחזיר את כל ההפניות לדפים הנתונים.
revisions
קבלת מידע על גרסה.
search
ביצוע חיפוש בכל הטקסט.
templates
החזרת כל הדפים המוכללים בדפים הנתונים.
transcludedin
מציאת כל הדפים שמכלילים את הדפים הנתונים.
watchlist
קבלת שינויים אחרונים לדפים ברשימת המעקב של המשתמש הנוכחי.
watchlistraw
קבלת כל הדפים ברשימת המעקב של המשתמש הנוכחי.
אחד מהערכים הבאים: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

פתרון אוטומטי של הפניות ב־titles, ב־pageids, וב־revids, ובדפים שמחזיר generator.

סוג: בוליאני (פרטים)
converttitles

המרת כותרות לסוגי כתב אחרים אם זה נחוץ. זה עובד רק אם שפת הכותרת של הוויקי תומכת בהמרת סוגי כתב. השפות שתומכות בהמרת סוגי כתב הן en, crh, gan, iu, kk, ku, shi, sr, tg, uz וגם zh.

סוג: בוליאני (פרטים)
token

אסימון "watch" שאוחזר מ־action=query&meta=tokens

פרמטר זה נדרש.
דוגמאות:
לעקוב אחרי הדף Main Page.
api.php?action=watch&titles=Main_Page&token=123ABC [פתיחה בארגז חול]
להפסיק את המעקב אחרי הדף Main Page.
api.php?action=watch&titles=Main_Page&unwatch=&token=123ABC [פתיחה בארגז חול]
לעקוב אחרי הדפים הראשונים במרחב הראשי.
api.php?action=watch&generator=allpages&gapnamespace=0&token=123ABC [פתיחה בארגז חול]