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 100.
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ı
maxolarak 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
limitsözcüğünden oluşur. Örneğin,imlimitdöndürülen en fazlaimagessayısıdır.
- 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ı
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 –
allusersveyarecentchangesgibi 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)