Template:ApiEx/csb

This page is a translated version of the page Template:ApiEx and the translation is 43% complete.

Dokumentacja szablonu

Ùżëj tãch szablònu na strónach dokumentacji API, bëżë wëktòrzëwë czëkání API.

Uwaga, jako alternatywë, {{Api help }} zôwë rozlëcznioną dokumentacjô API, co je генерòwane z kòdë źródłowégò, w ktòrym zazwyczaj sã znajdują przykłôdy API.

User:SPage (WMF)/ApiEx utility stwórzé szablon wezwania {{ApiEx }}, gdy wkleisz adres api.php do niego.

Użyczi

{{ApiEx
| desc=Capitalization, localization, "_" => " ", "Project" => "Wikipedia", ...
| p1=action=query
| p2=titles=Project:articleA{{!}}article_B
| result=<syntaxhighlight lang="xml">
<api>
  <query>
    <normalized>
      <n from="Project:articleA" to="Wikipedia:ArticleA" />
      <n from="article_B" to="Article B" />
    </normalized>
    <pages>
      <page ns="4" title="Wikipedia:ArticleA" missing="" />
      <page ns="0" title="Article B" missing="" />
    </pages>
  </query>
</api>
</syntaxhighlight>
| post={{ApiEx/Post|parameter=days|value=integer|default=7|comment=comment}}
}}

Paramëtrë

desc — API request description
lang — two-letter code for the wiki language. 'en' by default.
site — full URL of site to use in example (e.g., www.mediawiki.org). Overrides lang parameter.
p1-p9 — parameter groups, each containing either one param=value pair or multiple pairs each separated by an ampersand (&), e.g. p3=param=value&paramB=valueBbbb
result — the result of the query execution. Add the template, preview, click the api.php link, and copy and paste the API response into the template as | result=<syntaxhighlight lang="javascript">PASTE RESPONSE HERE</syntaxhighlight>
post — a "list" of {{ApiEx/Post }} objects, to generate a post table
collapse — set to "no" to stop "result" and "post" sections from being collapsed with {{Collapse top }}/{{Collapse bottom }}
apisandbox — whether to show a "[try in ApiSandbox]" link that loads the example API query parameters into Special:ApiSandbox. Default is 1, add | apisandbox=0 to not show this link.

Notes

This template outputs a wikitext link. Any spaces in the URL parameters p1...p9 will garble the link, so change them to %20.
Similarly, any pipe-separate values in the URL parameters such as a group of pages "title1|title2" must be escaped, so use the {{!}} magic word.

Example

Capitalization, localization, "_" => " ", "Project" => "Wikipedia", ...

api.php?action=query&titles=Project:articleA|article_B [próbëj w ApiSandbox]

Wynik

Nôzë parametrë	Wartość	Domëślnie	Kòméntarz
Paramëtrë pòsta
days	integer	7	comment

<api>
  <query>
    <normalized>
      <n from="Project:articleA" to="Wikipedia:ArticleA" />
      <n from="article_B" to="Article B" />
    </normalized>
    <pages>
      <page ns="4" title="Wikipedia:ArticleA" missing="" />
      <page ns="0" title="Article B" missing="" />
    </pages>
  </query>
</api>