Jump to content

API:Vlastnosti

From mediawiki.org
This page is a translated version of the page API:Properties and the translation is 100% complete.

Požadavek GET pro výpis vlastností vybraných stránek.

Dokumentace API

Vlastnosti jsou data o stránce, jako jsou kategorie, nebo obsah na stránce, jako jsou obrázky nebo odkazy. Chcete-li požádat o vlastnost, předáte parametru prop vašeho dotazu platný submodul vlastnosti, který odpovídá informacím, které potřebujete.

Stránka nebo stránky, jejichž data požadujete, jsou specifikovány buď titles, pageids, nebo revids parametry dotazu, nebo pomocí zdroje .

Dotazy na vlastnosti se zapisují takto: action=query&titles=title1&prop=property1|property2.

Dotazy na vlastnosti mají vždy omezený počet vrácených položek. Chcete-li zobrazit více položek, připojte hodnoty uvnitř prvku continue výsledku k původnímu požadavku.

Konkrétní příklady použití vlastností naleznete na stránkách API jednotlivých služeb:


Další poznámky

  • Většinu submodulů vlastností lze použít jako zdroje , pokud není uvedeno jinak.
  • Limity dotazů na vlastnosti:
    • Výsledky pro dotazy na vlastnosti mají vždy limit. Výchozí limit je 10. 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.
    • Pokud si nejste jisti, který limit se na vás vztahuje, a chcete jen co nejvíce výsledků, nastavte limit na max. V takovém případě bude vrácen prvek limits s uvedením použitých limitů.
    • Parametr limit pro daný modul se skládá z prefixu modulu následovaného slovem limit. Například imlimit je maximální počet vrácených images.

Související odkazy