Nápověda k MediaWiki API

Toto je automaticky generovaná dokumentační stránka k MediaWiki API.

Dokumentace a příklady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

prop=imageinfo (ii)

(main | query | imageinfo)

Tento modul vyžaduje oprávnění ke čtení.
Zdroj: MediaWiki
Licence: GPL-2.0-or-later

Vráti informácie o súbore a históriu nahrávania.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Imageinfo

Parametry:

K dispozícii sú aj ďalšie všeobecné parametre.

iiprop

Ktoré informácie o súbore získať:

timestamp: Pridá časovú pečiatku nahranej verzie.
user: Pridá používateľa, ktorý nahral každú verziu súboru. Ak bol používateľ skrytý pomocou vymazania revízií, vráti sa vlastnosť userhidden.
userid: Pridá ID používateľa, ktorý nahral každú verziu súboru. Ak bol používateľ skrytý pomocou vymazania revízií, vráti sa vlastnosť userhidden.
comment: Komentár k verzii. Ak bol komentár skrytý pomocou vymazania revízií, vráti sa vlastnosť commenthidden.
parsedcomment: Parsovať komentár k verzii. Ak bol komentár skrytý pomocou vymazania revízií, vráti sa vlastnosť commenthidden.
canonicaltitle: Pridá kanonický názov súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
url: Vráti URL súboru a stránky s popisom. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
size: Pridá veľkosť súboru v bajtoch a výšku, šírku a počet strán (ak je to použiteľné).
dimensions: Alias pre size.
sha1: Pridá SHA-1 hash súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
mime: Pridá MIME typ súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
thumbmime: Pridá MIME typ náhľadu obrázka (vyžaduje url a parameter iiurlwidth). Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
mediatype: Pridá typ média súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
metadata: Vypíše Exif metadáta verzie súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
commonmetadata: Vypíše všeobecné metadáta formátu súboru pre verziu súboru. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
extmetadata: Vypíše formátované metadáta kombinované z viacerých zdrojov. Výsledky sú formátované ako HTML. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.

Poznámka: Táto vlastnosť je nákladná na vyžiadanie a mali by ste sa jej vyhnúť, pokiaľ ju nepotrebujete. Pri jej použití by ste mali naraz žiadať len niekoľko výsledkov, aby ste predišli prílišnej záťaži.

archivename: Pridá názov súboru archívnej verzie pre iné ako najnovšie verzie. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
bitdepth: Pridá bitovú hĺbku verzie. Ak bol súbor skrytý pomocou vymazania revízií, vráti sa vlastnosť filehidden.
uploadwarning: Používa ju stránka Special:Upload na získanie informácií o existujúcom súbore. Nie je určená na použitie mimo jadra MediaWiki.
badfile: Pridá, či je súbor na zozname chybných obrázkov

Hodnoty (oddělené | nebo alternativou.): archivename, badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, thumbmime, timestamp, uploadwarning, url, user, userid

Predvolené: timestamp|user

iilimit

Koľko revízií súboru vrátiť na jeden súbor.

Typ: celé číslo alebo max

Hodnota musí byť medzi 1 a 500.

Predvolené: 1

iistart

Časová pečiatka, od ktorej sa má začať výpis.

Typ: časová pečiatka (povolené formáty)

iiend

Časová pečiatka, pri ktorej sa má výpis zastaviť.

Typ: časová pečiatka (povolené formáty)

iiurlwidth

Ak je nastavené iiprop=url, vráti sa URL obrázka škálovaného na túto šírku. Z výkonnostných dôvodov sa pri použití tejto voľby vráti najviac 50 škálovaných obrázkov.

Typ: celé číslo

Predvolené: -1

iiurlheight

Podobné ako iiurlwidth.

Typ: celé číslo

Predvolené: -1

iimetadataversion

Verzia metadát, ktorá sa má použiť. Ak je zadané latest, použije sa najnovšia verzia. Predvolená je 1 kvôli spätnej kompatibilite.

Predvolené: 1

iiextmetadatalanguage

V akom jazyku získať extmetadata. Ovplyvňuje to, ktorý preklad sa získa, ak je ich dostupných viac, ako aj formátovanie čísel a rôznych hodnôt.

Predvolené: cs

iiextmetadatamultilang

Ak sú dostupné preklady vlastnosti extmetadata, získať všetky.

Typ: logická hodnota (boolean) (podrobnosti)

iiextmetadatafilter

Ak je zadané a neprázdne, vrátia sa iba tieto kľúče pre iiprop=extmetadata.

Hodnoty oddělujte pomocí | nebo alternativou.

Maximálny počet hodnôt je 50 (500 pre klientov s povolenými vyššími limitmi).

iiurlparam

Reťazec parametrov špecifický pre obslužný program (handler). Napríklad PDF môžu používať page15-100px. Musí sa použiť iiurlwidth a musí byť konzistentné s iiurlparam.

Implicitní hodnota: (prázdné)

iibadfilecontexttitle

Ak je nastavené badfilecontexttitleprop=badfile, toto je názov stránky použitý pri vyhodnocovaní zoznamu chybných obrázkov

iicontinue

Keď je dostupných viac výsledkov, použite toto na pokračovanie. Podrobnejšie informácie o tom, ako pokračovať v dotazoch, nájdete na mediawiki.org.

iilocalonly

Hľadať iba súbory v miestnom úložisku.

Typ: logická hodnota (boolean) (podrobnosti)

Příklady:

Získať informácie o aktuálnej verzii súboru File:Albert Einstein Head.jpg.: api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [otevřít v pískovišti]
Získať informácie o verziách súboru File:Test.jpg z roku 2008 a novších.: api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [otevřít v pískovišti]