API:Import/ja

トークン
ページを取り込むには、取り込みトークン (import token) が必要です. このトークンは編集トークンと同じで、すべてのページに対して同じトークンを使用できますが、ログインのたびに変化します. 取り込みトークンは以下のようにして取得できます:

ページの取り込み
action=import でページを取り込めます. 取り込みには、XML ファイルのアップロード、または別のページの指定、を使用できます (後者はウィキ間転送 (transwiki) とも呼ばれます).

パラメーター
(アップロード) の印があるパラメーターは、XML ファイルのアップロードによる取り込みのみに使用します. 同様に、(インターウィキ) の印があるパラメーターは、別のウィキからの取り込み (ウィキ間転送) のみに使用します.
 * : The token obtained in the previous request. Take care to urlencode the trailing +\ as %2B%5C
 * : Summary for the import log (省略可能)
 * : Uploaded XML file (アップロード)
 * : Wiki to import from (インターウィキ)
 * The possible values for this parameter differ per wiki, see $wgImportSources. If the list of possible values for this parameter is empty, interwiki imports are disabled
 * : Title of the page to import (インターウィキ)
 * : If set, import the full history rather than just the current revision (インターウィキ)
 * : Namespace to import to. If not set, don't change the page's namespace (インターウィキ)
 * : Import all included templates as well (インターウィキ)

例
注記: In these examples, all parameters are passed in a GET request just for the sake of simplicity. However, action=import requires POST requests; GET requests will cause an error.

XML ファイル
When uploading a file, you need to use  as Content-Type or enctype,   will not work. The parameter xml is not a file name, but the actual content of a file.

Ruby source code example using httpclient (assumes login cookies are already in @headers)

起こりうるエラー
All errors are formatted as:


 * code: notoken
 * info: The token parameter must be set
 * code: cantimport
 * info: You don't have permission to import pages
 * code: cantimport-upload
 * info: You don't have permission to import uploaded pages
 * code: nointerwikipage
 * info: The interwikipage parameter must be set
 * code: nofile
 * info: You didn't upload a file
 * code: filetoobig
 * info: The file you uploaded is bigger than the maximum upload size
 * code: partialupload
 * info: The file was only partially uploaded
 * code: notempdir
 * info: The temporary upload directory is missing
 * This generally means the server is broken or misconfigured
 * code: cantopenfile
 * info: Couldn't open the uploaded file
 * This generally means the server is broken or misconfigured
 * code: badinterwiki
 * info: Invalid interwiki title specified
 * code: import-unknownerror
 * info: Unknown error on import: ``error ''

関連項目

 * ページの書き出し