API:REST API/ja

メディアウィキに関する REST APIは個別のURLに関するHTTP許諾を送り、MediaWikiとやりとりができます. APIを使用するとアプリやスクリプトを構築し、Wikiページの検索と表示や、メディアファイルの取得、ページ履歴の探索月できます.



クイックスタート
$ curl



データ形式
REST APIエンドポイントが返すデータ形式はJSONまたはHTMLです. エンドポイント単位の適合するコンテンツの種別はAPI 参考情報を参照してください.

メソッド
The API supports standard HTTP request methods.



URL の構造
API endpoints share a consistent URL structure that includes the wiki's base URL, the wiki's script path, and the API version.

Versioning
Designed to provide long-term stability for developers, the MediaWiki REST API is versioned using a global version number in the API path (for example: ). Following the principles of semantic versioning, the version is incremented when an endpoint is changed in a backwards-incompatible way, such as removing a response property or adding a required parameter. Within a major version, the API may change in backwards-compatible ways, such as adding a response property or optional request parameter.

Permissions and authorization
The REST API is designed to be used with the extension for user authentication and authorization. However, regardless of the authentication method, the API responds to the presence of a logged-in user and returns content appropriate to that user's permissions.

Accessing Wikimedia projects using the REST API
You can use the REST API to access Wikipedia, Wiktionary, and other Wikimedia projects in multiple languages. For a complete list of Wikimedia project URLs, see Meta-Wiki’s site matrix.

Request limit
There is no fixed limit on requests to the API, but your client may be blocked if you endanger the stability of a site. To stay within a safe request rate, wait for each request to finish before sending another request.

Client identification
Wikimedia sites require an HTTP User-Agent header for all API requests. This helps identify your app and ensures that system administrators can contact you if a problem arises. Clients making requests without a User-Agent header may be IP-blocked without notice.

The User-Agent header can include a user page on the local wiki, a user page on a related wiki using interwiki linking syntax, a URL for a relevant external website, or an email address.

If you are calling the API from browser-based JavaScript, you may not be able to influence the User-Agent header, depending on the browser. To work around this, use the   header. See Meta-Wiki’s User-Agent policy for more information.

認証
個別の利用者の代わりに皆さんのアプリを認証するには、アプリの登録とOAuthトークン使用の許諾はOAuth 開発者ガイドを参照してください.



ライセンスと商標
ウィキメディアのコンテンツは、該当するライセンスで指定された規約の範囲で自由に再利用できます. ライセンスはプロジェクトごとに異なり、個別のプロジェクトのライセンスとコンテンツ利用の情報を参照してください. 一例として英語版ウィキペディアの文章の再利用は クリエーティブコモンズ表示-継承 3.0 非移植の規約に従いますが、ウィキメディア・コモンズにあるメディアファイルはそれぞれの情報源ページに個別にライセンス条件を示してあります. ライセンス要件と商標使用に関する詳細は、メタウィキの開発者ガイドラインを参照してください.



ウィキデータの制限事項
REST API はウィキメディアのプロジェクト群で利用可能ですが、 ウィキデータとの連係は完全ではありません. この原稿の時点では、エンドポイントによっては想定外のエラーを返す可能性があります.



拡張機能のエンドポイント
REST API拡張機能を使うと、 MediaWiki 拡張機能の固有のAPI エンドポイントを可視化できます. 最初にREST API 拡張機能のインタフェース文書 を読んでから作業を始めてください. REST API 拡張機能から得られるエンドポイントに関する解説文書は、 拡張機能の解説文書を参照してください. REST API 拡張インタフェースは経由でから、またでよ入手でき、今後は既定で展開する予定です.



APIの対比


文書について
これらの解説文書はに従い、書き下ろしました. 訂正や加筆をお待ちしています. MediaWiki REST API関連のチュートリアルやアプリの紹介は、REST API テンプレートを編集してリンクを記入してください.

