עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=search (sr)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
ביצוע חיפוש בכל הטקסט.
פרמטרים:
- srsearch
חיפוש שמות דפים או תוכן שמתאים לערך הזה. אפשר להשתמש בחיפוש מחרוזת כדי לקרוא לאפשרויות חיפוש מתקדמות, בהתאם למה שממומש בשרת החיפוש של הוויקי.
- הפרמטר הזה נדרש.
- srnamespace
חיפוש רק במרחבי השם האלה.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 102, 103, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 128, 200, 201, 204, 205, 206, 207, 274, 275, 420, 421, 828, 829, 2300, 2301, 2302, 2303
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- ברירת המחדל: 0
- srlimit
כמה דפים להחזיר בסך הכול.
- סוג: מספר שלם או max
- הערך חייב להיות בין 1 ל־500.
- ברירת המחדל: 10
- sroffset
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- סוג: מספר שלם
- ברירת המחדל: 0
- srqiprofile
באיזה פרופיל בלתי־תלוי בשאילתה להשתמש (משפיע על אלגוריתם הדירוג).
- classic
- דירוג המבוסס על מספר הקישורים הנכנסים, תבניות מסוימות, דף הערך והאחרונוּת (ייתכן שתבניות, שפות ואחרונוּת אינם מופעלים בוויקי הזה).
- classic_noboostlinks
- דירוג המבוסס על תבניות אחדוֹת, שפת הדף והאחרונוּת כאשר זה מופעל בוויקי הזה.
- empty
- דירוג שמבוסס רק על אפשרויות שתלויות בשאילתה (רק לשם תיקון שגיאות).
- wsum_inclinks
- סכום משוקלל על סמך קישורים נכנסים
- wsum_inclinks_pv
- סכום משוקלל על סמך קישורים נכנסים וצפיות שבועיות בדפים
- popular_inclinks_pv
- דירוג מבוסס בעיקר על מספר הצפיות בדפים
- popular_inclinks
- דירוג מבוסס בעיקר על מספר הקישורים על הדף
- engine_autoselect
- לתת למנוע החיפוש לבחור את הפרופיל הטוב ביותר לשימוש.
- אחד מהערכים הבאים: classic, classic_noboostlinks, empty, engine_autoselect, popular_inclinks, popular_inclinks_pv, wsum_inclinks, wsum_inclinks_pv
- ברירת המחדל: engine_autoselect
- srwhat
איזה סוג חיפוש לבצע.
- אחד מהערכים הבאים: nearmatch, text, title
- srinfo
אילו מטא־נתונים להחזיר.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): rewrittenquery, suggestion, totalhits
- ברירת המחדל: totalhits|suggestion|rewrittenquery
- srprop
אילו מאפיינים להחזיר:
- size
- הוספת גודל הדף בבתים.
- wordcount
- הוספת מניין המילים של הדף.
- timestamp
- הוספת חותם־הזמן של העריכה האחרונה של הדף.
- snippet
- הוספת קטע קצר מפוענח מהדף.
- titlesnippet
- הוספת קטע קצר מפוענח משם הדף.
- redirecttitle
- הוספת שם ההפניה התואמת.
- redirectsnippet
- הוספת קטע קצר מפוענח משם ההפניה.
- sectiontitle
- הוספת שם הפסקה התואמת.
- sectionsnippet
- הוספת קטע קצר מפוענח של שם הפסקה התואמת.
- isfilematch
- הוספת בוליאני שמציין אם החיפוש תאם לתוכן של קובץ.
- categorysnippet
- הוספת קטע קצר מפוענח של הקטגוריה התואמת.
- score
- מיושן. חסר־השפעה.
- hasrelated
- מיושן. חסר־השפעה.
- extensiondata
- הוספת נתונים נוספים שנוצרים על־ידי הרחבות.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): categorysnippet, extensiondata, isfilematch, redirectsnippet, redirecttitle, sectionsnippet, sectiontitle, size, snippet, timestamp, titlesnippet, wordcount, hasrelated, score
- ברירת המחדל: size|wordcount|timestamp|snippet
- srinterwiki
לכלול תוצאות בינוויקי בחיפוש, אם זמין.
- סוג: בוליאני (פרטים)
- srenablerewrites
הפעלת שכתוב שאילתות פנימי. שרתי חיפוש אחדים יכולים לשכתב את השאילתה לצורה אחרת שנחשבת לכזאת שמספקת תוצאות טובות יותר, למשל באמצעות תיקון שגיאות כתיב.
- סוג: בוליאני (פרטים)
- srsort
קביעת סדר המיון של התוצאות המוחזרות.
- אחד מהערכים הבאים: create_timestamp_asc, create_timestamp_desc, incoming_links_asc, incoming_links_desc, just_match, last_edit_asc, last_edit_desc, none, random, relevance
- ברירת המחדל: relevance
דוגמאות:
- חיפוש meaning.
- api.php?action=query&list=search&srsearch=meaning [פתיחה בארגז חול]
- חיפוש טקסטים עבור meaning.
- api.php?action=query&list=search&srwhat=text&srsearch=meaning [פתיחה בארגז חול]
- קבלת מידע על הדף עבור שמוחזרים מחיפוש אחרי meaning.
- api.php?action=query&generator=search&gsrsearch=meaning&prop=info [פתיחה בארגז חול]