עזרה של MediaWiki API

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

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

action=tag

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

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

פרמטרים:
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 [פתיחה בארגז חול]