API:Seznamy
Tato stránka je součástí dokumentace k API Action MediaWiki. |
Požadavek GET pro seznam položek, které odpovídají vybraným kritériím.
Dokumentace API
Seznamy obecně vracejí agregace dat, jako jsou stránky shromážděné z celé wiki nebo odkazy shromážděné na jedné stránce. Chcete-li požádat o seznam, předejte parametru list
vašeho řetězce dotazu platný submodul seznamu, například allimages
nebo usercontribs
.
Chcete-li použít seznam API, zadejte v adrese URL action=query&list=list1|list2
.
Konkrétní příklady použití seznamů naleznete na stránkách API jednotlivých seznamů:
- 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
Další poznámky
- Většinu submodulů seznamu lze použít jako zdroje , pokud není uvedeno jinak.
- Seznamy se od properties liší v tom, že namísto přidávání dat k prvkům v prvku
pages
má každý seznam svou vlastní oddělenou větev v prvkuquery
. - Seznam limitů dotazů:
- Limit výsledků lze nastavit až na 500 pro běžné uživatele nebo 5000 pro uživatele s právem
apihighlimits
(obvykle boti a sysopové). - Některé moduly ukládají za určitých podmínek přísnější limity. Další podrobnosti najdete na této podstránce .
- Pokud si nejste jisti, který limit se vás týká, a chcete jen co nejvíce výsledků, nastavte limit na
max
. V takovém případě bude vrácen prveklimits
určující použité limity. - Parametr limitu pro daný modul se skládá z prefixu modulu následovaného
limit
, takžeptlimit
je maximální počet vrácenýchprotectedtitles
acmlimit
je maximální počet vrácenýchcategorymembers
.
- Limit výsledků lze nastavit až na 500 pro běžné uživatele nebo 5000 pro uživatele s právem
Související odkazy
- Spravováno MediaWiki Interfaces Team.
- Živý chat (IRC): #mediawiki-core připojit se
- Nástroj pro sledování problémů: Phabricator MediaWiki-Action-API (nahlášení problému)