עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
action=query
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0+
אחזור נתונים ממדיה־ויקי ועליה.
כל שינויי הנתונים יצטרכו תחילה להשתמש ב־query כדי לקבל אסימון למניעת שימוש לרעה מאתרים זדוניים.
- prop
אילו מאפיינים לקבל על הדפים בשאילתה.
- ערכים (מופרדים באמצעות "|"): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageprops, redirects, revisions, stashimageinfo, templates, transcludedin
- list
אילו רשימות לקבל.
- ערכים (מופרדים באמצעות "|"): allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, allusers, backlinks, blocks, categorymembers, deletedrevs, embeddedin, exturlusage, filearchive, imageusage, iwbacklinks, langbacklinks, logevents, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw
- meta
אילו מטא־נתונים לקבל.
- ערכים (מופרדים באמצעות "|"): allmessages, filerepoinfo, siteinfo, tokens, userinfo
- indexpageids
לכלול פסקת pageids נוספת עם רשימת כל מזהי הדף שהוחזרו.
- סוג: בוליאני (פרטים)
- export
יצוא הגרסאות הנוכחיות של כל הדפים הנתונים המחוללים.
- סוג: בוליאני (פרטים)
- exportnowrap
להחזיר את ה־XML של היצוא בלי לעטוף אותו בתוצאת XML (אותו תסדיר כמו Special:Export). אפשר להשתמש בזה רק עם export.
- סוג: בוליאני (פרטים)
- iwurl
האם לקבל את ה־URL המלא אם הכותרת היא קישור בינוויקי.
- סוג: בוליאני (פרטים)
- continue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- rawcontinue
להחזיר נתוני query-continue גולמיים להמשך.
- סוג: בוליאני (פרטים)
- titles
רשימת כותרות.
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- pageids
רשימת מזהי דף לעבוד עליהם.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- revids
רשימת מזהי גרסה לעבוד עליהם.
- סוג: רשימת מספרים שלמים
- הפרדה בין ערכים נעשית באמצעות | מספר הערכים המרבי הוא 50 (עבור בוטים – 500).
- generator
קבלת רשימת דפים לעבוד עליהם על־ידי הרצת יחידת ה־query שצוינה.
לתשומת לבך: לשמות בפרמטר generator צריכה להיות התחילית "g", ר' דוגמאות.
- אחד מהערכים הבאים: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
- redirects
פתרון אוטומטי של הפניות ב־titles, ב־pageids, וב־revids, ובדפים שמחזיר generator.
- סוג: בוליאני (פרטים)
- converttitles
המרת כותרות לסוגי כתב אחרים אם זה נחוץ. זה עובד רק אם שפת הכותרת של הוויקי תומכת בהמרת סוגי כתב. השפות שתומכות בהמרת סוגי כתב הן gan, iu, kk, ku, shi, sr, tg, uz, zh.
- סוג: בוליאני (פרטים)
- אחזור site info ו־revisions של Main Page.
- api.php?action=query&prop=revisions&meta=siteinfo&titles=Main%20Page&rvprop=user|comment&continue=
- אחזור גרסאת של דפים שמתחילים ב־API/.
- api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue=