עזרה של MediaWiki API

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

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

action=edit

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

יצירה ועריכה של דפים.

פרמטרים:
title

שם הדף לעריכה. לא לשימוש עם pageid.

pageid

מזהה הדף לעריכה. לא לשימוש עם title.

סוג: מספר שלם
section

מספר הפסקה 0 לפסקה העליונה, new לפסקה חדשה.

sectiontitle

הכותרת לפסקה החדשה.

text

תוכן הדף.

summary

תקציר עריכה. גם גותרת פסקה כש־section=new ו־sectiontitle אינו מוגדר.

tags

אילו תגי שינוי להחיל על הגרסה.

ערכים (מופרדים באמצעות "|"):
minor

עריכה משנית.

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

שינוי לא משני.

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

סימון עריכה זו כבוט.

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

חותם־זמן של גרסת הבסיס, משמש לזיהוי התנגשויות עריכה. אפשר לקבל אותו באמצעות action=query&prop=revisions&rvprop=timestamp.

סוג: חותם־זמן (תסדירים מורשים)
starttimestamp

חותם־הזמן של תחילת תהליך העריכה, משמש לזיהוי התנגשויות. אפשר לקבל ערך מתאים באמצעות curtimestamp בעת תחילת תהליך העריכה (למשל בזמן טעינת תוכן הדף לעריכה).

סוג: חותם־זמן (תסדירים מורשים)
recreate

לעקוב את כל הטעויות על כך שהדף נמחק בינתיים.

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

לא לערוך את הדף אם הוא כבר קיים.

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

לזרוק שגיאה אם הדף אינו קיים.

סוג: בוליאני (פרטים)
watch
מיושן.

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

סוג: בוליאני (פרטים)
unwatch
מיושן.

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

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

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

אחד מהערכים הבאים: watch, unwatch, preferences, nochange
ברירת מחדל: preferences
md5

גיבוב MD5 של הפרמטר text או צירוף של הפטמטרים prependtext ו־appendtext. אם זה מוגדר, העריכה לא תיעשה אלא אם כן הגיבוב נכון.

prependtext

הוספת הטקסט הזה לתחילת הדף. דורס את text.

appendtext

הוספת הטקסט הזה לסוף הדף. דורס את text.

יש להשתמש ב־section=new כדי להוסיף פסקה חדשה, ולא בפרמטר הזה.

undo

לבטל את הגרסה הזאת. דורס את text‏, prependtext ו־appendtext.

סוג: מספר שלם
undoafter

ביטול כל הגרסאות מ־undo עד כאן. אם זה לא מוגדר, לבטל רק גרסה אחת.

סוג: מספר שלם
redirect

לפתור הפניות אוטומטית.

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

תסדיר להסדרת תוכן שמשמש את טקסט הקלט.

אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
contentmodel

מודל התוכן של התוכן החדש.

אחד מהערכים הבאים: wikitext, javascript, json, css, text
token

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

האסימון תמיד צריך להישלח בתור הפרמטר האחרון, או לפחות אחרי הפרמטר text parameter.

פרמטר זה נדרש.