עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
list=search (sr)
- יחידה זו דורשת הרשאות קריאה.
- אפשר להשתמש ביחידה הזאת בתור מחולל.
- מקור: MediaWiki
- רישיון: GPL-2.0+
ביצוע חיפוש בכל הטקסט.
פרמטרים:
- srsearch
חיפוש שמות דפים או תוכן שמתאים לערך הזה. אפשר להשתמש בחיפוש מחרוזת כדי לקרוא לאפשרויות חיפוש מתקדמות, בהתאם למה שממומש בשרת החיפוש של הוויקי.
- פרמטר זה נדרש.
- srnamespace
חיפוש רק במרחבי השם האלה.
- ערכים (מופרדים באמצעות "|"): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- ברירת מחדל: 0
- srwhat
איזה סוג חיפוש לבצע.
- אחד מהערכים הבאים: title, text, nearmatch
- srinfo
אילו מטא־נתונים להחזיר.
- ערכים (מופרדים באמצעות "|"): totalhits, suggestion, rewrittenquery
- ברירת מחדל: totalhits|suggestion|rewrittenquery
- srprop
אילו מאפיינים להחזיר:
- size
- הוספת גודל הדף בבתים.
- wordcount
- הוספת מניין המילים של הדף.
- timestamp
- הוספת חותם־הזמן של העריכה האחרונה של הדף.
- snippet
- הוספת קטע קצר מפוענח מהדף.
- titlesnippet
- הוספת קטע קצר מפוענח משם הדף.
- redirecttitle
- הוספת שם ההפניה התואמת.
- redirectsnippet
- הוספת קטע קצר מפוענח משם ההפניה.
- sectiontitle
- הוספת שם הפסקה התואמת.
- sectionsnippet
- הוספת קטע קצר מפוענח של שם הפסקה התואמת.
- isfilematch
- הוספת בוליאני שמציין אם החיפוש תאם לתוכן של קובץ.
- categorysnippet
- הוספת קטע קצר מפוענח של הקטגוריה התואמת.
- score
- מיושן וחסר־השפעה.
- hasrelated
- מיושן וחסר־השפעה.
- ערכים (מופרדים באמצעות "|"): size, wordcount, timestamp, snippet, titlesnippet, redirecttitle, redirectsnippet, sectiontitle, sectionsnippet, isfilematch, categorysnippet, score, hasrelated
- ברירת מחדל: size|wordcount|timestamp|snippet
- sroffset
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך.
- סוג: מספר שלם
- ברירת מחדל: 0
- srlimit
כמה דפים להחזיר בסך הכול.
- המספר המרבי המותר הוא 50 (עבור בוטים – 500).
- סוג: מספר שלם או max
- ברירת מחדל: 10
- srinterwiki
לכלול תוצאות בינוויקי בחיפוש, אם זמין.
- סוג: בוליאני (פרטים)
- srenablerewrites
הפעלת שכתוב שאילתות פנימי. שרתי חיפוש אחדים יכולים לשכתב את השאילתה לצורה שלדעתם נותנת תוצאות טובות יותר, למשל תיקון שגיאות כתיב.
- סוג: בוליאני (פרטים)
דוגמאות:
- חיפוש 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