עזרה של MediaWiki API

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

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

list=alldeletedrevisions (adr)

(main | query | alldeletedrevisions)

יחידה זו דורשת הרשאות קריאה.
אפשר להשתמש ביחידה הזאת בתור מחולל.
מקור: MediaWiki
רישיון: GPL-2.0-or-later

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

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Alldeletedrevisions

פרמטרים ייעודיים:

זמינים פרמטרים כלליים אחרים.

adrprop

אילו מאפיינים לקבל עבור כל גרסה:

ids: מזהה הגרסה.
flags: דגלי גרסה (משני).
timestamp: חותם־הזמן של הגרסה.
user: המשתמש שעשה את הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
userid: מזהה המשתמש של יוצר הגרסה. אם המשתמש נמחק במחיקת גרסאות, יוחזר המאפיין userhidden.
size: אורך (בבתים) של הגרסה.
slotsize: אורך (בבתים) של כל משבצת גרסה.
sha1: SHA-1 (בבסיס 16) של הגרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
slotsha1: SHA-1 (בסיס 16) של כל משבצת גרסה. אם התוכן נמחק במחיקת גרסאות, יוחזר המאפיין sha1hidden.
contentmodel: מזהה מודל התוכן של כל משבצת גרסה.
comment: הערה מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
parsedcomment: הערה מפוענחת מאת המשתמש על הגרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין commenthidden.
content: התוכן של כל משבצת גרסה. אם התקציר נמחק במחיקת גרסאות, יוחזר המאפיין texthidden. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של adrlimit יחויב להיות 50.
tags: התגים עבור הגרסה.
roles: רשימת תפקידי משבצות תוכן שקיימות בגרסה.
parsetree: מיושן. יש להשתמש ב־ action=expandtemplates או ב־action=parse במקום בזה. עץ פענוח ה־XML של תוכן הגרסה (דורש מודל תוכן wikitext). מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של adrlimit יחויב להיות 50.

ערכים (מופרדים באמצעות "|" או or תו חלופי): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree

ברירת המחדל: ids|timestamp|flags|comment|user

adrslots

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

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

כדי לתת את כל הערכים, יש להשתמש ב־*.

adrcontentformat-{slot}

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

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

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

adrlimit

להגביל כמה גרסאות יוחזרו. אם משמש adrprop=content, adrprop=parsetree, adrdiffto או adrdifftotext, המגבלה היא 50. אם משמש adrparse, המגבלה היא 1.

סוג: מספר שלם או max

הערך חייב להיות בין 1 ל־500.

adrexpandtemplates

מיושן.

יש להשתמש ב־action=expandtemplates במקום בזה. לפרוס תבניות בתוכן הגרסה (דורש adrprop=content).

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

adrgeneratexml

מיושן.

יש להשתמש ב־action=expandtemplates או ב־action=parse במקום בזה. יצירת עץ פענוח XML עבור תוכן הגרסה (דורש את adrprop=content; מוחלף ב־adrprop=parsetree).

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

adrparse

מיושן.

יש להשתמש ב־action=parse במקום בזה. פענוח תוכן הגרסה (דורש adrprop=content). מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של adrlimit יחויב להיות 1.

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

adrsection

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

adrdiffto

מיושן.

יש להשתמש ב־action=compare במקום בזה. מזהה הגרסה שכל גרסה תושווה אליה. יש להשתמש ב־prev‏, next ו־cur עבור הגרסה הקודמת, הבאה והנוכחית, בהתאמה. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של adrlimit יחויב להיות 50.

adrdifftotext

מיושן.

יש להשתמש ב־action=compare במקום בזה. הטקסט שכל גרסה גרסה תושווה אליו. מבצע השוואה רק של מספר מוגבל של גרסאות. דורס את adrdiffto. אם מוגדר adrsection, רק הפסקה הזאת תושווה אל מול הטקסט הזה. מטעמי ביצועים, אם האפשרות הזאת משמשת, הערך של adrlimit יחויב להיות 50.

adrdifftotextpst

מיושן.

יש להשתמש ב־action=compare במקום בזה. ביצוע התמרה לפני שמירה על הטקסט לפני הרצת השוואה. תקף רק כשמשמש עם adrdifftotext.

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

adrcontentformat

מיושן.

תסדיר ההסדרה שמשמש את adrdifftotext וצפוי לפלט של תוכן.

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

adruser

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

לתשומת ליבך: בשל מצב חיסכון, שימוש ב־adruser וב־adrnamespace ביחד עלול להניב החזרה של פחות מ־adrlimit תוצאות לפני המשך; במצבים קיצוניים יכולות להיות מוחזרות אפס תוצאות.

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")

adrnamespace

לרשום רק דפים במרחב השם הזה.

לתשומת ליבך: בשל מצב חיסכון, שימוש ב־adruser וב־adrnamespace ביחד עלול להניב החזרה של פחות מ־adrlimit תוצאות לפני המשך; במצבים קיצוניים יכולות להיות מוחזרות אפס תוצאות.

ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 108, 109, 110, 111, 710, 711, 828, 829

כדי לתת את כל הערכים, יש להשתמש ב־*.

adrstart

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

יכול לשמש רק adruser.

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

adrend

באיזה חותם־זמן להפסיק למנות.

יכול לשמש רק adruser.

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

adrdir

באיזה כיוון למנות:

newer: לרשום את הישנים ביותר בהתחלה. לתשומת ליבך: adrstart חייב להיות לפני adrend.
older: לרשום את החדשים ביותר בהתחלה (ברירת מחדל). לתשומת ליבך: adrstart חייב להיות אחרי adrend.

אחד מהערכים הבאים: newer, older

ברירת המחדל: older

adrfrom

להתחיל את הרשימה בשם הזה.

לא יכול לשמש עם adruser.

adrto

להפסיק את הרשימה בכותרת הזאת.

לא יכול לשמש עם adruser.

adrprefix

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

לא יכול לשמש עם adruser.

adrexcludeuser

לא לרשום גרסאות מאת המשתמש הזה.

לא יכול לשמש עם adruser.

סוג: משתמש, בכל אחת מהצורות הבאות: שם משתמש, כתובת IP, חשבון חולף, שם משתמש שהגיע מאתר ויקי אחר (כגון "prefix>ExampleName") וגם מספר מזהה של משתמש (כגון "#12345")

adrtag

לרשום רק גרסאות עם התג הזה.

adrcontinue

כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.

adrgeneratetitles

בעת שימוש בתור מחולל, לחולל כותרת במקום מזהי גרסה.

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

דוגמאות:

לרשום את 50 התרומות המחוקות האחרונות של משתמש Example.: api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50 [פתיחה בארגז חול]
רשימת 50 הגרסאות המחוקות הראשונות במרחב הראשי.: api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrnamespace=0&adrlimit=50 [פתיחה בארגז חול]