API:画像の情報

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page API:Imageinfo and the translation is 71% complete.

Other languages:
English • ‎dansk • ‎español • ‎français • ‎русский • ‎日本語
MediaWiki バージョン: 1.11

画像ファイルまたはファイルについての情報を取得する GET リクエストです。

This module can be used as a generator .

APIの説明文書


prop=imageinfo (ii)

(main | query | imageinfo)

Returns file information and upload history.

Parameters:
iiprop

Which file information to get:

timestamp
Adds timestamp for the uploaded version.
user
Adds the user who uploaded each file version.
userid
Add the ID of the user that uploaded each file version.
comment
Comment on the version.
parsedcomment
Parse the comment on the version.
canonicaltitle
Adds the canonical title of the file.
url
Gives URL to the file and the description page.
size
Adds the size of the file in bytes and the height, width and page count (if applicable).
dimensions
Alias for size.
sha1
Adds SHA-1 hash for the file.
mime
Adds MIME type of the file.
thumbmime
Adds MIME type of the image thumbnail (requires url and param iiurlwidth).
mediatype
Adds the media type of the file.
metadata
Lists Exif metadata for the version of the file.
commonmetadata
Lists file format generic metadata for the version of the file.
extmetadata
Lists formatted metadata combined from multiple sources. Results are HTML formatted.
archivename
Adds the filename of the archive version for non-latest versions.
bitdepth
Adds the bit depth of the version.
uploadwarning
Used by the Special:Upload page to get information about an existing file. Not intended for use outside MediaWiki core.
badfile
Adds whether the file is on the MediaWiki:Bad image list
Values (separate with | or alternative): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning, badfile
Default: timestamp|user
iilimit

How many file revisions to return per file.

No more than 500 (5,000 for bots) allowed.
Type: integer or max
Default: 1
iistart

Timestamp to start listing from.

Type: timestamp (allowed formats)
iiend

Timestamp to stop listing at.

Type: timestamp (allowed formats)
iiurlwidth

If iiprop=url is set, a URL to an image scaled to this width will be returned.

For performance reasons if this option is used, no more than 50 scaled images will be returned.

Type: integer
Default: -1
iiurlheight

Similar to iiurlwidth.

Type: integer
Default: -1
iimetadataversion

Version of metadata to use. If latest is specified, use latest version. Defaults to 1 for backwards compatibility.

Default: 1
iiextmetadatalanguage

What language to fetch extmetadata in. This affects both which translation to fetch, if multiple are available, as well as how things like numbers and various values are formatted.

Default: en
iiextmetadatamultilang

If translations for extmetadata property are available, fetch all of them.

Type: boolean (details)
iiextmetadatafilter

If specified and non-empty, only these keys will be returned for iiprop=extmetadata.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).
iiurlparam

A handler specific parameter string. For example, PDFs might use page15-100px. iiurlwidth must be used and be consistent with iiurlparam.

Default: (empty)
iibadfilecontexttitle

If badfilecontexttitleprop=badfile is set, this is the page title used when evaluating the MediaWiki:Bad image list

iicontinue

When more results are available, use this to continue.

iilocalonly

Look only for files in the local repository.

Type: boolean (details)

GET リクエスト

Get information about the file, File:Billy_Tipton.jpg


レスポンス

Request URL:

{
    "batchcomplete": "",
    "query": {
        "normalized": [
            {
                "from": "File:Billy_Tipton.jpg",
                "to": "File:Billy Tipton.jpg"
            }
        ],
        "pages": {
            "36266497": {
                "pageid": 36266497,
                "ns": 6,
                "title": "File:Billy Tipton.jpg",
                "imagerepository": "local",
                "imageinfo": [
                    {
                        "timestamp": "2012-06-27T21:16:21Z",
                        "user": "Gobonobo"
                    }
                ]
            }
        }
    }
}

サンプル コード

get_imageinfo.py

#!/usr/bin/python3

"""
    get_imageinfo.py

    MediaWiki Action API Code Samples
    Demo of `Imageinfo` module: Get information about 
    an image file.
    MIT license
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action":"query",
    "format":"json",
    "prop": "imageinfo",
    "titles":"File:Billy_Tipton.jpg",
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

print(DATA)

デモ アプリ

起こりうるエラー

コード 情報
invalid-title Invalid title in iibadfilecontexttitle parameter.
? Invalid value for iiurlparam (name=value).
? Could not normalize image parameters for $1.

パラメーターの履歴

  • v1.23: canonicaltitle, commonmetadata, iiextmetadatalanguage, iiextmetadatamultilang, iiextmetadatafilter を導入しました
  • v1.22: uploadwarning を導入しました
  • v1.20: iilocalonly を導入しました
  • v1.18: iimetadataversion, iiurlparam を導入しました
  • v1.17: userid, parsedcomment, thumbmime, extmetadata を導入しました
  • v1.16: dimensions を導入しました
  • v1.15: iicontinue を導入しました
  • v1.14: bitdepth を導入しました
  • v1.13: mime, archivename を導入しました
  • v1.12: iihistory を廃止予定にしました
  • v1.12: iilimit, iistart, iiend, iiurlwidth, iiurlheight を導入しました

追加的な注記

  • Files uploaded to the Wikimedia Commons will appear to be missing when accessed from other MediaWiki wikis.
  • The timestamp from this module indicates the last time the image was modified.

関連項目