עזרה של MediaWiki API

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

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

action=tag

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

הוספה או הסרה של תגים מגרסאות בודדות או רשומות יומן בודדות.

פרמטרים:
rcid

מזהה שינוי אחרון אחד או יותר שתג יתווסף אליו או יוסר ממנו.

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

מזהה גרסה אחד או יותר שתג יתווסף אליה או יוסר ממנה.

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

מזהה רשומת יומן אחת או יותר שתג יתווסף אליה או יוסר ממנה.

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

התגים להוספה. אפשר להוסיף רק תגים קיימים.

ערכים (מופרדים באמצעות "|" או or תו חלופי): צ'קטי, שחזור ידני
remove

תגים להסרה. רק תגים שהוגדרו ידנית או שאינם מוגדרים כלל יכולים להיות מוסרים.

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

סיבה לשינוי.

ברירת מחדל: (ריק)
tags

אילו תגים להחיל על רשומת היומן שתיווצר כתוצאה מהפעולה הזאת.

ערכים (מופרדים באמצעות "|" או or תו חלופי): צ'קטי, שחזור ידני
token

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

הפרמטר הזה נדרש.
דוגמאות:
הוספת התג vandalism לגרסה עם המזהה 123 בלי לציין סיבה
api.php?action=tag&revid=123&add=vandalism&token=123ABC [פתיחה בארגז חול]
הסרת התג spam מרשומה עם המזהה 123 עם הסיבה Wrongly applied
api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC [פתיחה בארגז חול]