עזרה של MediaWiki API

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

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

action=edit

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

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

פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
title

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

pageid

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

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

מזהה הפרק 0 לפרק העליון, new לפרק חדש. לעיתים קרובות זהו מספר חיובי, אבל יכול להיות גם לא מספרי.

sectiontitle

הכותרת לפרק החדש בעת שימוש ב־section=new.

text

תוכן הדף.

summary

תקציר עריכה.

אם הפרמטר הזה אינו מסופק או ריק, תקציר עריכה יכול להיות מחולל אוטומטית.

כשנעשה שימוש ב־section=new ו־sectiontitle אינו מסופק, הערך של הפרמטר הזה משמש לכותרת הפרק, ותקציר העריכה מחולל אוטומטית.

tags

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

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

סימון העריכה בתור משנית.

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

לא לסמן את העריכה הזאת בתור משנית אפילו כשמופעלת ההעדפה "סימון כל העריכות כמשניות בתור ברירת מחדל".

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

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

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

מזהה גרסת הבסיס, משמש לזיהוי התנגשויות עריכה. אפשר להשיג אותו באמצעות action=query&prop=revisions. התנגשויות עצמיות גורמות לעריכה להיכשל אלא אם מוגדר basetimestamp.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

prependtext

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

appendtext

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

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

undo

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

סוג: מספר שלם
הערך לא יכול להיות קטן מ־0.
undoafter

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

סוג: מספר שלם
הערך לא יכול להיות קטן מ־0.
redirect

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

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

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

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

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

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

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

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

הפרמטר הזה נדרש.
g-recaptcha-response

שדה מכלי ReCaptcha.