עזרה של MediaWiki API

וועלכע אקציע אויסצופירן.

abusefiltercheckmatch

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

abusefilterchecksyntax

בדיקת תחביר של אחד ממסנני ההשחתות.

abusefilterevalexpression

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

abusefilterunblockautopromote

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

abuselogprivatedetails

צפייה במידע פרטי של רשומת יומן השחתה.

acquiretempusername

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

antispoof

בדיקת שם משתמש אל מול בדיקות נרמול של AntiSpoof.

block

חסימת משתמש.

centralauthtoken

אחזור centralauthtoken לביצוע בקשה מאומתת לוויקי משויך.

centralnoticecdncacheupdatebanner

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

centralnoticechoicedata

קבלת נתונים שדרושים לבחירת כרזה למיזם ושפה הנתונים

centralnoticequerycampaign

קבלת כל ההגדרות של מבצע הפרסום.

changeauthenticationdata

שינוי נתוני אימות עבור המשתמש הנוכחי.

changecontentmodel

שינוי מודל התוכן של דף

checktoken

בדיקת התקינות של האסימון מ־action=query&meta=tokens.

clearhasmsg

מנקה את דגל hasmsg עבור המשתמש הנוכחי.

clientlogin

כניסה לוויקי באמצעות זרימה הידודית.

communityconfigurationedit

Change the content of a configuration provider in Community configuration

compare

קבלת ההבדל בין שני דפים.

createaccount

יצירת חשבון משתמש חדש.

createlocalaccount

יצירת חשבון מקומי בכפייה. החשבון המרכזי חייב להתקיים.

delete

מחיקת דף.

deleteglobalaccount

מחיקת משתמש גלובלי.

discussiontoolsedit

שליחת הודעה בדף שיחה.

discussiontoolsfindcomment

מציאת תגובה לפי המזהה או השם שלה.

discussiontoolsgetsubscriptions

קבלת מצב המעקב של הנושאים הנתונים.

discussiontoolssubscribe

להירשם (או לבטל רישום) לקבלת התראות על נושא

discussiontoolsthank

לשלוח התראה על הודעת תודה פומבית על תגובה.

echocreateevent

גרימה ידנית לשליחת התראה למשתמש

echomarkread

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

echomarkseen

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

echomute

השתקה או הפעלה של התראות ממשתמשים או מדפים מסוימים.

edit

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

editmassmessagelist

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

emailuser

שליחת דוא"ל למשתמש.

expandtemplates

פורס את כל התבניות בתוך קוד הוויקי.

featuredfeed

החזרת הזנת תוכן מומלץ.

feedcontributions

מחזיר הזנת תרומות משתמש.

feedrecentchanges

מחזיר הזנת שינויים אחרונים.

feedwatchlist

מחזיר הזנת רשימת מעקב.

filerevert

שחזור קובץ לגרסה ישנה יותר.

globalblock

חסימה גלובלית או שחרור חסימה גלובלית של משתמש.

globalpreferenceoverrides

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

globalpreferences

שינוי ההעדפות הגלובליות של המשתמש הנוכחי.

globaluserrights

הוספה/הסרה של משתמש אל/מתוך קבוצות גלובליות.

help

הצגת עזרה עבור היחידות שצוינו.

imagerotate

המודול הזאת כובה.

import

יבוא דף מוויקי אחר או מקובץ XML.

jsonconfig

אפשרות לגישה ישירה לתת־מערכת של JsonConfig.

languagesearch

חיפוש של שמות שפות בכל שיטת כתב.

linkaccount

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

login

כניסה וקבלת עוגיות אימות.

logout

יציאה וניקוי של נתוני ההתחברות.

managetags

ביצוע פעולות ניהוליות הקשורות בתגי שינוי.

massmessage

שליחת הודעה לרשימת דפים.

mergehistory

מיזוג גרסאות של דפים.

move

העברת דף.

opensearch

חיפוש בוויקי בפרוטוקול OpenSearch.

options

שינוי העדפות של המשתמש הנוכחי.

paraminfo

קבלת מידע על יחידות של API.

parse

מפענח את התוכן ומחזיר פלט מפענח.

patrol

לנטר דף או גרסה.

protect

לשנות את רמת ההגנה של דף.

purge

ניקוי המטמון לכותרות שניתנו.

query

אחזור נתונים ממדיה־ויקי ועליה.

removeauthenticationdata

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

resetpassword

שליחת דוא"ל איפוס סיסמה למשתמש.

revisiondelete

מחיקה ושחזור ממחיקה של גרסאות.

rollback

ביטול העריכה האחרונה לדף.

rsd

יצוא סכמת RSD‏ (Really Simple Discovery).

setglobalaccountstatus

הסתרה או נעילה (או ביטול הסתרה או ביטול נעילה) של חשבון משתמש גלובלי.

setnotificationtimestamp

עדכון חותם־הזמן של ההודעה עבור דפים במעקב.

setpagelanguage

שינוי השפה של דף.

shortenurl

קיצור כתובת URL ארוכה.

sitematrix

קבלת רשימת אתרי ויקימדיה.

spamblacklist

בדיקת תקינות של URL אחד או יותר אל מול רשימת חסימת הספאם.

streamconfigs

חשיפת הגדרות זרם אירועים. מחזיר רק format=json עם formatversion=2.

strikevote

מתן אפשרות למפעילי מערכת למחוק קול או לבטל את מחיקתו.

tag

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

templatedata

אפנעמען דאטן געשפייכלערט דורך דער TemplateData פֿארברייטערונג.

thank

שליחת התראת תודה לעורך.

titleblacklist

בדיקת תקינות של כותרת דף, שם קובץ, או שם משתמש אל מול TitleBlacklist.

torblock

בדיקה אם כתובת IP חסומה בתור צומת יציאה של Tor.

transcodereset

משתמשים עם ההרשאה "transcode-reset" יכולים לאתחל ולהריץ מחדש משימת המרה משנית.

unblock

שחרור חסימת משתמש.

undelete

שחזור גרסאות של דף מחוק.

unlinkaccount

ביטול קישור של חשבון צד־שלישי מהמשתמש הנוכחי.

upload

העלאת קובץ, או קבלת מצב ההעלאות הממתינות.

userrights

שינוי חברות בקבוצות של המשתמש.

validatepassword

לבדוק תקינות סיסמה אל מול מדיניות הסיסמאות של הוויקי.

watch

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

webapp-manifest

החזרת המניפסט של יישום הרשת.

webauthn

מודול API לתקשורת בין השרת ללקוח בעת תהליך רישום/אימות.

wikifunctions_run

הרצת קריאה לפונקציה

wikilambda_fetch

אחזור מודל JSON של עצמי Z.

abstractwiki_fetch_section

פנימי. Request the currently available Abstract Wikipedia rendered fragments for the given topic Qid (Wikidata Item Id), section Qid, language Zid and date. Alternatively (and only with special rights), request the currently available rendered output of an array of fragments passed in the request, which can be different from the currently persisted version.

This request is never blocking. When any of the requested fragments is not ready, the retuned value for that fragment will have a "pending" flag set to true.

The response is always guaranteed to return as many results as requested -- For example, if the "fragments" param is empty and the requested section has N fragments, all N will be returned; similarly, if M fragments are requested in the "fragments" parameter, the respond will return M items.

abstractwiki_run_fragment

פנימי. תיצוג קטע תוכן של ויקיפדיה מופשטת עבור מזהה פריט ויקינתונים, מזהה Z של שפה ותאריך

bouncehandler

פנימי. קבלת דוא"ל קופץ ועיבודו כדי לטפל במקבל כושל.

categorytree

פנימי. מודול פנימי של ההרחבה CategoryTree.

chartinfo

פנימי. אחזור הספירה הנוכחית של מספר השימושים הייחודיים ב־Chart. שימושים מרובים באותו תרשים באותו דף נחשבים לשימוש יחיד.

cirrus-check-sanity

פנימי. דיווח על על הנכונות של טווח מזהי דף במפתח החיפוש

cirrus-config-dump

פנימי. היטל של הגדרות CirrusSearch.

cirrus-profiles-dump

פנימי. היטל של פרופילי CirrusSearch עבור הוויקי הזה.

cirrus-schema-dump

פנימי. Dump of CirrusSearch schema (settings and mappings) for this wiki.

codemirror-validate

פנימי. חיפוש שגיאות בדיקת תקינות בתוכן הנתון

collection

פנימי. מודול API לביצוע פעולות מגוונות על אוסף של משתמש ויקי.

cspreport

פנימי. משמש דפדפנים לדיווח הפרות של מדיניות אבטחת תוכן. המודול הזה לעולם לא ישמש אלא אם הוא משמש עם דפדפן תומך CSP.

discussiontoolscompare

פנימי. קבלת מידע על שינויי תגובות בין שתי גרסאות דף.

discussiontoolspageinfo

פנימי. מחזירה מטא־נתונים דרושים כדי לאתחל את כלי השיחה.

discussiontoolspreview

פנימי. תצוגה מקדימה של הודעה בדף שיחה.

editcheckreferenceurl

פנימי. Check the status of a URL for use as a reference.

fancycaptchareload

פנימי. קבלת FancyCaptcha חדשה.

jsondata

פנימי. אחזור נתוני JSON המותאמים למקום.

jsontransform

פנימי. אחזור נתוני JSON שהותמרו על־ידי פונקציית לואה.

parser-migration

פנימי. פענוח דף עם שתי תצורות שונות של המפענח.

readinglists

פנימי. פעולות כתיבה ברשימות קריאה.

sanitize-mapdata

פנימי. ביצוע בדיקת תקינות נתונים עבור ההרחבה Kartographer

scribunto-console

פנימי. יחידה פנימית להבאת בקשות XHR ממסוף Scribunto.

securepollauth

פנימי. מאפשרת לוויקי מרוחק לאמת משתמשים לפני מתן זכות להצביע בבחירות.

stashedit

פנימי. הכנת עריכה במטמון משותף.

timedtext

פנימי. מספק תוכן טקסט מתוזמן לשימוש ברכיבי <track>

ulslocalization

פנימי. קבלת תרגומי ממשק של בורר השפות האוניברסלי בשפה הנתונה.

ulssetlang

פנימי. לעדכן את שפת הממשק המועדפת של המשתמש.

visualeditor

פנימי. החזרת HTML5 עבור דף מתוך שירות פרסואיד.

visualeditoredit

פנימי. שמירת דף HTML5 למדיה־ויקי (מומר לקוד ויקי דרך שירות פרסואיד).

wikifunctions_html_sanitiser

פנימי. API לחיטוי מחרוזת HTML בשביל תצוגה למשתמש באתר Wikifunctions.org ואתרי ויקי לקוח של ויקימדיה.

wikilambda_edit

פנימי. ליצור או לערוך עצם Z.

wikilambda_function_call

פנימי. קריאה לפונקציה באמצעות קריאה למתזמר הפונקציה

wikilambda_perform_test

פנימי. נקודת קצה להרצת שאילתות אל מול תוצאות בדיקות עבור פונקציית Z. מקבלת פונקציית Z, רשימת מימושי Z, ורשימה של בודקי Z. מקבלת רשימת מזהי Z או עצם Z שלם עבור הפונקציה, מימושים, או בודקים. מקבלת גם מפתח האם להשתמש במטמון צד שרת או לא.

wikilambda_supported_programming_languages

פנימי. אחזור שפות התכנות הנתמכות על־ידי המעריך

wikimediaeventsblockededit

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

wikimediaeventshcaptchaeditattempt

פנימי. Log edit diff when hCaptcha challenge is shown but edit is incomplete

פארמאט פונעם אויסגאב.

json

לפלוט נתונים בתסדיר JSON.

jsonfm

לפלוט נתונים בתסדיר JSON (עם הדפסה יפה ב־HTML).

none

לא לפלוט שום דבר.

rawfm

לפלוט את הנתונים, כולל אלמנטים לניפוי שגיאות, בתסדיר JSON (עם הדפסה יפה ב־HTML).

xml

לפלוט נתונים בתסדיר XML.

xmlfm

לפלוט נתונים בתסדיר XML (עם הדפסה יפה ב־HTML).

שיהוי מרבי יכול לשמש כשמדיה־ויקי מותקנת באשכול עם מסד נתונים משוכפל. כדי לחסוך בפעולות שגורמות יותר שיהוי בשכפול אתר, הפרמטר הזה יכול לגרום ללקוח להמתין עד ששיהוי השכפול יורד מתחת לערך שצוין. במקרה של שיהוי מוגזם, קוד השגיאה maxlag מוחזר עם הודעה כמו Waiting for $host: $lag seconds lagged.
ר' מדריך למשתמש: פרמטר maxlag למידע נוסף.

להגדיר את כותר s-maxage לבקרת מטמון HTTP‏ למספר כזה של שניות. שגיאות אף פעם לא מוטמנות.

להגדיר את כותר max-age לבקרת מטמון HTTP‏ למספר כזה של שניות. שגיאות אף פעם לא מוטמנות.

לוודא שהמשתמש נכנס לחשבון (וייתכן שבתור חשבון חולף) אם זה מוגדר ל־user, שלא נכנס לחשבון אם מוגדר anon, או שיש לו הרשאת המשתמש "בוט" אם זה bot.

לוודא שהמשתמש הנוכחי הוא המשתמש ששמו ניתן.

כל ערך שיינתן כאן ייכלל בתשובה. אפשר להשתמש בזה כדי להבדיל בין בקשות.

לכלול את שם המארח ששירת את הבקשה בתוצאות.

לכלול את חותם־הזמן הנוכחי בתוצאה.

לכלול את השפות שמשמשות ל־uselang ול־errorlang בתוצאה.

בעת גישה ל־API עם בקשת AJAX חוצה תחומים (CORS), יש להציב כאן את התחום שהבקשה יוצאת ממנו. זה היה להיות כלול בכל בקשה מקדימה, ולכן הוא חייב להיות חלק מה־URL של הבקשה (לא גוף ה־POST).

עבור בקשות מאומתות, זה חייב להיות תואם במדויק לאחד המקורות בכותרת Origin, כך שזה צריך להיות מוגדר למשהו כמו https://en.wikipedia.org או https://meta.wikimedia.org. אם הפרמטר הזה אינו תואם לכותרת Origin, תוחזר תשובת 403. אם הפרמטר הזה תורם לכותרת Origin והמקור מורשה, תוגדרנה הכותרות Access-Control-Allow-Origin ו־Access-Control-Allow-Credentials.

עבור בקשות בלתי־מאומתות, יש לציין את הערך *. זה יגרום לכותרת להיות Access-Control-Allow-Origin, אבל Access-Control-Allow-Credentials תהיה false וכל הנתונים הייחודיים למשתמש יהיו מוגבלים.

בעת גישה לממשק ה־API באמצעות בקשת AJAX חוצה־תחומים (CORS) ושימוש בספק התחברות (session) מאובטח מפני מתקפות זיוף בקשות חוצות אתרים (CSRF), כגון OAuth, יש להשתמש בזה ולא ב־origin=* כדי לאמת את הבקשה (כלומר, שהיא לא תהיה של משתמש שלא נכנס לחשבון). זה חייב להיכלל בכל בקשה לפני טיסה, ולכן חייב להיות חלק מה־URL של הבקשה (ולא בגוף ה־POST).

נא לשים לב לכך שרוב ספקי ההתחברות, כולל התחברויות תקניות שמבוססות על עוגיות, אינם תומכים ב־CORS מאומת ולא ניתן להשתמש בהם עם הפרמטר הזה.

באיזו שפה להשתמש לתרגומי הודעות. הקריאה action=query&meta=siteinfo&siprop=languages מחזירה רשימת קודים. באפשרותך לציין user כדי להשתמש בהעדפת השפה של המשתמש הנוכחי או content כדי להשתמש בשפת התוכן של הוויקי הזה.

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

תסדיר לשימוש בפלט טקסט אזהרות ושגיאות

plaintext

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

wikitext

קוד ויקי לא מפוענח.

html

HTML

raw

מפתח הודעה ופרמטרים.

none

ללא פלט טקסט, רק הודעות השגיאה.

bc

התסדיר ששימש לפני מדיה־ויקי 1.29. התעלמות מ־errorlang ו־ errorsuselocal.

באיזו שפה להשתמש לאזהרות ושגיאות. הקריאה action=query&meta=siteinfo&siprop=languages מחזירה רשימת קודים. באפשרותך לציין content כדי להשתמש בשפת התוכן של הוויקי הזה או uselang כדי להשתמש אותו הערך שיש בפרמטר uselang.

אם ניתן, הטקסטים של השגיאות ישתמשו בהודעות מותאמות מקומית ממרחב השם מעדיעװיקי.

בעת גישה לבקשת AJAX חוצה־תחומים (CORS), יש להשתמש בזה כדי להתאמת בתור משתמש SUL נוכחי. יש להשתמש ב־action=centralauthtoken באתר הוויקי הזה כדי לאחזר את האסימון לפי ביצוע בקשת CORS. בכל אסימון אפשר להשתמש רק פעם אחת, והוא פג אחרי 10 שניות. זה אמור להיכלל בכל בקשה לפני טיסה ולכן זה צריך להיות כלול ב־URI של הבקשה (לא בגוף ה־POST).

On this wiki the expected value is a JSON Web Token, which may be validated by proxy servers in front of MediaWiki. If the token has expired or is otherwise invalid, you may receive a HTTP error from a proxy in a different format than a normal API error.