API:Özellikler
Bu sayfa MediaWiki Eylem API'si belgelerinin bir parçasıdır. |
Seçilen sayfaların özelliklerini listelemek için GET isteği.
API belgesi
Özellikler, sayfalar hakkında kategoriler gibi veriler veya sayfadaki resimler veya bağlantılar gibi içeriklerdir.
Bir özellik istemek için, sorgunuzun prop
parametresini, ihtiyacınız olan bilgilere karşılık gelen geçerli bir özellik alt modülüne iletirsiniz.
Verilerini talep ettiğiniz sayfa veya sayfalar, sorgunun titles
, pageids
veya revids
parametreleriyle veya jeneratör yoluyla belirtilir.
Özellikler için sorgular şu şekilde yazılır: action=query&titles=title1&prop=property1|property2
.
Özellik sorgularında her zaman iade edilen öğe sayısında bir sınır vardır.
Daha fazla öğe görüntülemek için, sonucun continue
öğesinin içindeki değerleri orijinal isteğe ekleyin.
Özelliklerin kullanımına ilişkin daha somut örnekler için lütfen ayrı özellik API sayfalarına bakın:
Ek notlar
- Çoğu özellik alt modülü aksi belirtilmedikçe jeneratörler olarak kullanılabilir.
- Özellik sorgusu sınırları:
- Özellik sorgularının sonuçları her zaman bir sınıra sahiptir; varsayılan sınır 10. Sonuç sınırı, normal kullanıcılar için 500 veya
apihighlimits
(genellikle botlar ve sistem hizmetlileri) olan kullanıcılar için 5000 olarak ayarlanabilir. Bazı modüller belirli koşullar altında daha katı sınırlar uygular. - Hangi sınırın sizin için geçerli olduğundan emin değilseniz ve mümkün olduğunca çok sonuç istiyorsanız, sınırı
max
olarak ayarlayın. Bu durumda, kullanılan sınırları belirten birlimits
öğesi döndürülür. - Belirli bir modülün limit parametresi, modül önekinin ardından
limit
sözcüğünden oluşur. Örneğin,imlimit
döndürülen en fazlaimages
sayısıdır.
- Özellik sorgularının sonuçları her zaman bir sınıra sahiptir; varsayılan sınır 10. Sonuç sınırı, normal kullanıcılar için 500 veya
Ayrıca bakınız
- Sorgu modülündeki belgeler - tüm özellik alt modüllerinin, karşılık gelen parametrelerinin ve değerlerinin kısa bir açıklamasını içerir.
- API:Veritabanı alanı ve API özellik ilişkilendirmeleri - sorgu özelliklerinin MediaWiki veritabanı içindeki alanlarla nasıl ilişkilendirildiğini açıklayan bir tablo içerir.
- API:Listeler -
allusers
veyarecentchanges
gibi bilgi listelerine erişmek için benzer bir API.pages
öğesine veri ekleyen özellik sorgularının aksine, listelerquery
öğesinde ayrı bir dal döndürür.
- MediaWiki Interfaces Team tarafından korunur.
- Canlı sohbet (IRC): #mediawiki-core bağlan
- Sorun izleyicisi: Phabricator MediaWiki-Action-API (Sorun bildir)