API:Import/ja

トークン
ページを取り込むには、取り込みトークン (import token) が必要です. このトークンは編集トークンと同じで、すべてのページに対して同じトークンを使用できますが、ログインのたびに変化します. 取り込みImport tokens can be obtained via action=tokens with type=import (MW 1.20+), or by using the following method:

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

パラメーター
(アップロード) の印があるパラメーターは、XML ファイルのアップロードによる取り込みのみに使用します. 同様に、(インターウィキ) の印があるパラメーターは、別のウィキからの取り込み (ウィキ間転送) のみに使用します.
 * : 以前のリクエストで取得したトークン. 必ず末尾の +\ を %2B%5C に urlencode するようにしてください
 * : 取り込み記録用の要約 (省略可能)
 * : アップロードする XML ファイル (アップロード)
 * : 取り込み元のウィキ (インターウィキ)
 * 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
 * : 取り込み先ページのページ名 (インターウィキ)
 * : 設定した場合、現在の版のみではなく、完全な履歴を取り込む (インターウィキ)
 * : 取り込み先の名前空間. 設定しなかった場合、ページの名前空間を変更しません (インターウィキ)
 * : 参照読み込みされたテンプレートもすべて取り込む (インターウィキ)

例
注記: 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 ''

関連項目

 * ページの書き出し