עזרה של MediaWiki API

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

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

action=opensearch

(main | opensearch)
  • יחידה זו דורשת הרשאות קריאה.
  • מקור: MediaWiki
  • רישיון: GPL-2.0-or-later

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

פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
search

מחרוזת לחיפוש.

הפרמטר הזה נדרש.
namespace

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

ערכים (מופרדים באמצעות "|" או 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
כדי לתת את כל הערכים, יש להשתמש ב־*.
ברירת המחדל: 0
limit

מספר התוצאות המרבי להחזרה.

סוג: מספר שלם או max
הערך חייב להיות בין 1 ל־500.
ברירת המחדל: 10
profile

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

strict
פרופיל מחמיר שבו מוסָרים מעט סימני פיסוק, אבל סימנים דיאקריטיים וסימני הטעמה נשמרים.
normal
מוסָרים סימני פיסוק אחדים, סימנים דיאקריטיים מסוימים ומילות עצירה מסוימות.
fuzzy
דומה לרגיל עם תיקון שגיאות הקלדה (נתמכות שתי שגיאות הקלדה).
fast-fuzzy
פרופיל מטושטש ניסיוני (יכול להיות מוסר בכל זמן)
classic
תחילית קלאסית, שבה מוסָרים מעט סימני פיסוק וסימנים דיאקריטיים אחדים.
engine_autoselect
לתת למנוע החיפוש לבחור את הפרופיל הטוב ביותר לשימוש.
אחד מהערכים הבאים: classic, engine_autoselect, fast-fuzzy, fuzzy, normal, strict
ברירת המחדל: engine_autoselect
suggest
מיושן.

כבר לא בשימוש.

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

איך לטפל בהפניות:

return
להחזיר את ההפניה עצמה.
resolve
להחזיר את דף היעד. יכול להחזיר פחות מ־limit תוצאות.

מסיבות היסטוריות, ברירת המחדל היא "return" עבור format=json ו־"resolve" עבור תסדירים אחרים.

אחד מהערכים הבאים: resolve, return
format

תסדיר הפלט.

אחד מהערכים הבאים: json, jsonfm, xml, xmlfm
ברירת המחדל: json
warningsaserror

אם אזהרות מוּעלות עם format=json, להחזיר שגיאת API במקום להתעלם מהן.

סוג: בוליאני (פרטים)
דוגמה:
חיפוש דפים שמתחילים ב־Te.
api.php?action=opensearch&search=Te [פתיחה בארגז חול]