עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=info (in)
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת מידע בסיסי על הדף.
פרמטרים ייעודיים:
זמינים פרמטרים כלליים אחרים.
- inprop
אילו מאפיינים נוספים לקבל:
- protection
- לרשום את רמת ההגנה של כל דף.
- talkid
- מזהה הדף של דף השיחה עבור כל דף שאינו דף שיחה.
- watched
- לרשום את מצב המעקב של כל דף.
- watchers
- מספר העוקבים, אם קיבלת הרשאה.
- visitingwatchers
- מספר העוקבים אחרי כל דף שביקרו עריכות אחרונות לאותו הדף, אם זה מותר.
- notificationtimestamp
- חותם־זמן של הודעת רשימת מעקב של כל דף.
- subjectid
- מזהה הדף של הדף העיקרי של כל דף שיחה.
- associatedpage
- כותרת עם תחילית של דף הנושא או דף השיחה המשויך.
- url
- נותן URL מלא, URL לעריכה ו־URL קנוני לכל דף.
- readable
- מיושן. האם המשתמש יכול לקרוא את הדף הזה. יש להשתמש ב־intestactions=read במקום זה.
- preload
- נותן את הטקסט שמוחזר על־ידי EditFormPreloadText.
- displaytitle
- נותן את האופן שבה שם הדף באמת מוצג.
- varianttitles
- כותרת התצוגה בכל הגרסאות של שפת התוכן של האתר.
- linkclasses
- נותן מחלקות CSS נוספות (למשל צבעי קישורים) שמשמשים לקישורים לדף הזה אם הם מופיעים בדף ששמו ניתן על־ידי inlinkcontext.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): associatedpage, displaytitle, linkclasses, notificationtimestamp, preload, protection, subjectid, talkid, url, varianttitles, visitingwatchers, watched, watchers, readable
- inlinkcontext
כותרות ההקשר שישמש בעד קביעת מחלקות CSS נוספות (למשל צבעי קישורים) כש־inprop מכיל linkclasses.
- סוג: כותרת דף
- מקבל דפים שאינם קיימים.
- ברירת המחדל: עמוד ראשי
- intestactions
בדיקה האם המשתמש הנוכחי יכול לבצע פעולות מסוימות על הדף.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- intestactionsdetail
רמת פירוט של intestactions. יש להשתמש בפרמטרים errorformat ו־errorlang של המודול הראשי כדי לשלוט בתסדיר את ההודעות המוחזרות.
- boolean
- החזרת ערך בוליאני עבור כל פעולה.
- full
- החזרת הודעות שמתארות למה הפעולה אינה מותרת, או מערך ריק אם היא מותרת.
- quick
- כמו full, אבל בלי בדיקות יקרות.
- אחד מהערכים הבאים: boolean, full, quick
- ברירת המחדל: boolean
- incontinue
כשיש עוד תוצאות, להשתמש בזה בשביל להמשיך. אפשר למצוא מידע מפורט יותר על איך להמשיך שאילתות באתר mediawiki.org.
דוגמאות:
- קבלת מידע על הדף עמוד ראשי
- api.php?action=query&prop=info&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99 [פתיחה בארגז חול]
- קבלת מידע כללי ומידע על הגנה של הדף עמוד ראשי.
- api.php?action=query&prop=info&inprop=protection&titles=%D7%A2%D7%9E%D7%95%D7%93%20%D7%A8%D7%90%D7%A9%D7%99 [פתיחה בארגז חול]