API:Listeler
Bu sayfa MediaWiki Eylem API'si belgelerinin bir parçasıdır. |
Seçim ölçütleriyle eşleşen öğeleri listelemek için GET isteği.
API belgesi
Listeler genellikle bir viki üzerinden toplanan sayfalar veya tek bir sayfada toplanan bağlantılar gibi veri toplamalarını döndürür. Bir liste istemek için, sorgu dizenizin list
parametresini allimages
veya usercontribs
gibi geçerli bir liste alt modülüne iletin.
Liste API'sini kullanmak için URL'de action=query&list=list1|list2
belirtin.
Listelerin nasıl kullanılacağına dair daha somut örnekler için ayrı liste API sayfalarına bakın:
- allcategories
- alldeletedrevisions
- allfileusages
- allimages
- alllinks
- allpages
- allredirects
- allrevisions
- alltransclusions
- allusers
- backlinks
- blocks
- categorymembers
- deletedrevs
- embeddedin
- exturlusage
- filearchive
- imageusage
- iwbacklinks
- langbacklinks
- logevents
- pagepropnames
- pageswithprop
- prefixsearch
- protectedtitles
- querypage
- random
- recentchanges
- search
- tags
- usercontribs
- users
- watchlist
- watchlistraw
Ek notlar
- Liste alt modüllerinin çoğu, aksi belirtilmedikçe jeneratörler olarak kullanılabilir.
- Listeler properties öğesinden öğelere veri eklemek yerine properties öğesinden farklıdır, her listenin
query
öğesinde kendi ayrılmış dalı vardır. - Liste sorgu sınırları:
- 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. Daha fazla ayrıntı için bu alt sayfa sayfasına bakın.
- 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 limitleri belirten birlimits
öğesi döndürülecektir. - Belirli bir modülün limit parametresi modül önekinin ardından
limit
üzerinden oluşur, bu nedenleptlimit
döndürülen en fazlaprotectedtitles
vecmlimit
döndürülen en fazlacategorymembers
.
- Sonuç sınırı, normal kullanıcılar için 500 veya
Ayrıca bakınız
- MediaWiki Interfaces Team tarafından korunur.
- Canlı sohbet (IRC): #mediawiki-core bağlan
- Sorun izleyicisi: Phabricator MediaWiki-Action-API (Sorun bildir)