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