API:Query/he

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

מודולים עבור שאילתות
מודול השאילתא כולל שלושה סוגים של תת־מודולים (נקראים גם מודולי שאילתא):


 * אודות אתר הוויקי והמשתמש המחובר.


 * של דפים, כולל גרסאות של דפים ותוכן.


 * של דפים שתואמים קריטריון מסוים.

דוגמה 1: ציון דפים
בשונה ממודולי ה־meta וה־list במודול השאילתא, כל מודולי השיאלתא שמתייחסים למאפיינים עובדים עם מקבץ של דפים שניתן לציין אותם באחת מהדרכים הבאות:


 * לפי שם תוך שימוש בפרמטר, לדוגמה.


 * לפי מזהה הדף (ID) תוך שימוש בפרמטר, לדוגמה.


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


 * שימוש בגנרטור.

Example 2: Title normalization
Title normalization converts page titles to their canonical form.

This means capitalizing the first character, replacing underscores with spaces, and changing namespace to the localized form defined for that wiki.

דוגמה 3: כותרות שגויות או חסרות
Titles that don't exist or are invalid will have a  or   attribute set in the response.

In output formats that support numeric array keys, missing and invalid titles will have negative page IDs.

Example 4: Continuing queries
When all the data is not returned in the response of a query, there will be a  attribute to indicate that there is more data.

To get further data, add its values to the original request.

Example 5: Batchcomplete
The API returns a  element to indicate that all data for the current batch of items has been returned.

In the response of the sample query below,  has been included to indicate that all the data for each of the three images has been returned.

The next continuation will begin returning data for the next set of 3 images.

Example 6: Generators
Use generators if you want to get data about a set of pages.

For example, to get data about pages in a certain category, instead of querying  and then querying again with   set to all the returned pages, combine the two API calls into one by using.

When using a list module as a generator, you don't need to specify the pages.

However, for a property module, you should specify the pages which the generator will work on.

For example, to load all pages that are linked to from the main page, use.

Parameters passed to a generator must be prefixed with a. For instance, when using, use   instead of.

The sample query below gets links and categories for the first three pages in the main namespace starting with "Ba".

Parameter history

 * v1.21: Introduced
 * v1.24: Introduced  (note raw continuation was the default behavior until v1.26)

Additional notes

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * Use multiple query modules together to get what you need in one request, e.g..
 * Generators only pass page titles to the query module and do not output any information themselves. Setting parameters like  will therefore have no effect.

ראו גם

 * - מדריך ההתחלה המהירה.
 * - מכיל מידע אודות אופן השימוש בפרמטר.