עזרה של 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 [פתיחה בארגז חול]