עזרה של 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 [פתיחה בארגז חול]