API:Query/tr

modülü, belirli bir sayfanın vikimetini, bir sayfa grubunun bağlantıları ve kategorileri veya için gereken anahtar gibi bir viki ve içinde depolanan veriler hakkında bilgi almanıza olanak tanır.

Sorgu modülleri
Sorgu modülünde üç tür alt modül vardır (sorgu modülleri olarak da adlandırılır):


 * Viki ve giriş yapan kullanıcı hakkında.
 * Sayfa revizyonları ve içerik dahil olmak üzere sayfaların.
 * Belirli ölçütlerle eşleşen sayfaların.

Örnek 1: Sayfaları belirtme
Meta ve liste sorgu modüllerinden farklı olarak, tüm özellik sorgu modülleri, aşağıdaki yollardan biriyle belirtilebilen bir dizi sayfada çalışır:


 * parametresini kullanarak ada göre, ör..
 * parametresini kullanarak sayfa kimliğine göre, ör..
 * parametresini kullanarak revizyon kimliğiyle, ör. . Çoğu sorgu modülü, düzeltme kimliğini ilgili sayfa kimliğine dönüştürür. Revizyon kimliğinin kendisini yalnızca  kullanır.
 * Bir jeneratör kullanma.

Örnek 2: Başlık normalizasyonu
Başlık normalizasyonu sayfa başlıklarını kurallı biçimlerine dönüştürür.

Bu, ilk karakteri büyük harfe çevirme, alt çizgileri boşluklarla değiştirme ve ad alanını o viki için tanımlanan yerelleştirilmiş forma değiştirme anlamına gelir.

Örnek 3: Eksik ve geçersiz başlıklar
Mevcut olmayan veya geçersiz başlıklarda yanıtta  veya   bir özellik ayarlanmış olacaktır.

Sayısal dizi anahtarlarını destekleyen çıkış biçimlerinde, eksik ve geçersiz başlıkların negatif sayfa kimlikleri olacaktır.

Örnek 4: Devam eden sorgular
Bir sorguya yanıt olarak tüm veriler döndürülmediğinde, daha fazla veri olduğunu belirten  niteliği olacaktır.

Daha fazla veri almak için, değerlerini orijinal isteğe ekleyin.

Örnek 5: Toplu işlem tamamlama
API, geçerli öğe grubuna ilişkin tüm verilerin döndürüldüğünü belirtmek için  öğesi döndürür.

Aşağıdaki örnek sorguya yanıt olarak, üç görüntünün her biri için tüm verilerin döndürüldüğünü göstermek için  eklenmiştir.

Bir sonraki devam sonraki 3 resim kümesi için veri döndürmeye başlayacaktır.

Örnek 6: Jeneratörler
Bir dizi sayfa hakkında veri almak istiyorsanız jeneratörleri kullanın.

Örneğin,  sorgulamak ve sonra döndürülen tüm sayfalara ayarlanmış   ile tekrar sorgulamak yerine belirli bir kategorideki sayfalar hakkında veri almak için, iki API çağrısını   kullanarak bir araya getirin.

Liste modülünü jeneratör olarak kullanırken, sayfaları belirtmenize gerek yoktur.

Ancak, bir özellik modülü için, jeneratörün üzerinde çalışacağı sayfaları belirtin.

Örneğin, ana sayfadan bağlantı verilen tüm sayfaları yüklemek için  kullanın.

Bir jeneratöre iletilen parametrelerin önüne bir  eklenmelidir. Örneğin,  kullanırken,   yerine   kullanın.

Aşağıdaki örnek sorgu "Ba" ile başlayan ana ad alanındaki ilk üç sayfanın bağlantılarını ve kategorilerini alır.

Parametre geçmişi

 * v1.21:  tanıtıldı
 * v1.24:  tanıtıldı (not |ham devamı v1.26'ya kadar varsayılan davranıştır)

Ek notlar

 * Başlıkları  veya   ile belirtmek sorgu başına 50 başlık veya   hakkına sahip olanlar için 500 başlık ile sınırlıdır.
 * 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.

Resolving redirects
Redirects can be resolved automatically, so that the target of a redirect is returned instead of the given title. When present, they will always contain  and   attributes and may contain a   attribute for those redirects that point to specific sections.

Both normalization and redirection may take place. In the case of multiple redirects, all redirects will be resolved, and in case of a circular redirect, there might not be a page in the 'pages' section (see also below). Redirect resolution cannot be used in combination with the  parameter or with a generator generating revids; doing that will produce a warning and will not resolve redirects for the specified revids.

The examples below show how the  parameter works.