API:מאפיינים

This page is a translated version of the page API:Properties and the translation is 77% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎polski • ‎português • ‎română • ‎български • ‎русский • ‎українська • ‎עברית • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語

בקשת GET על מנת להכין רשימה של מאפיינים של דפים מסוימים.

תיעוד API

מאפיינים הם נתונים אודות דף כלשהו, למשל קטגוריות, או תוכן של דף, למשל תמונות או קישורים. על מנת לבקש מאפיין יש לשלוח דרך הפרמטר prop של השאילתא מאפיין תקין, שתואם למידע שברצונכם לקבל.

את הדף או הדפים שעבורם רוצים לקבל את הנתונים יש לציין בפרמטרים titles, pageids או revids של השאילתא, או דרך גנרטור .

שאילתות של מאפיינים נכתבות בערך כך: action=query&titles=title1&prop=property1|property2.

שאילתות של מאפיינים כוללים תמיד מגבלה על כמות הפריטים שמוחזרים. כדי לקבל פריטים נוספים, יש לצרף את הערכים שבתוך האלמנט continue של התשובה לתוך הבקשה הראשונה.

ניתן למצוא דוגמאות מדויקות אודות אופן השימוש במאפיינים בדפי ה־API המתאימים:

הערות נוספות

  • רוב תת־המודולים שמתייחסים למאפיינים יכולים לשמש גם בתור גנרטורים , אלא אם כן מצויין אחרת.
  • מגבלות על שאילתות מאפיינים:
    • תוצאות של שאילתות מאפיינים תמיד כוללים מגבלה כלשהי; מגבלת ברירת־המחדל היא 10. ניתן לשנות את המגבלה על מספר הפריטים בתוצאה ל־500 עבור משתמשים רגילים, או 5000 עבור משתמשים שמחזיקים בהרשאה apihighlimits (בדרך כלל בוטים ומפעילי מערכת). חלק מהמודולים כופים מגבלות קפדניות יותר תחת תנאים מסוימים.
    • אם אתם לא בטוחים איזו מגבלה חלה עליכם ואתם רק רוצים כמה תוצאות שניתן, יש לקבוע את המגבלה ל־max. במקרה זה, האלמנט limits יוחזר, כאשר הוא מציין את המגבלות שבהן השתמשו.
    • The limit parameter for a given module consists of the module prefix followed by the word limit.

לדוגמה, imlimit הוא המספר המרבי של images שמוחזרים.

ראו גם