API:Properties/he

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



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

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

שאילתות של מאפיינים נכתבות בערך כך:.

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

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





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



ראו גם

 * Documentation on query module - contains a brief description of all property submodules, their corresponding parameters, and values.
 * - contains a table describing how query properties are associated with the fields in a.
 * - a similar API, for accessing lists of information, such as, or  . Unlike property queries, which append data to the   element, lists return a separate branch in the   element.