ウィキメディア REST API
Appearance
ウィキメディアREST APIは、機械が読める形式でウィキメディアのコンテンツやメタデータへアクセスできるようにします。 大容量使用のケースに重点を置き、ウィキメディアのグローバルに分散されたキャッシュ インフラストラクチャと緊密に統合されています。 その結果、API ユーザーは、待ち時間の短縮と大量のリクエストのサポートというメリットを享受できます。
REST APIとその文書は、すべての主要なウィキメディア・プロジェクトで /api/rest_v1/ から入手できます。 たとえば、英語版ウィキペディアのREST APIとその文書はhttps://en.wikipedia.org/api/rest_v1/で入手可能です。
ウィキメディア・プロジェクトのほとんどが英語版ウィキペディアとほぼ同等の機能のREST APIを提供していますが、注目すべき例外がいくつかあります。
- wikimedia.org offers cross-project information like page view metrics.
- en.wiktionary.org offers an experimental definition end point, exposing Wiktionary information as structured data. Support for other languages is under discussion.
Versioning
The REST API follows this API versioning policy.
Terms and conditions
- By using the REST API, you agree to Wikimedia's general Terms of Use and Privacy Policy.
- To avoid impacting other API users, limit your clients to no more than 200 requests/sec to this API overall. Many entry points additionally specify and enforce more restrictive rate limits.
- We ask you to set a unique
User-Agent
orApi-User-Agent
header that allows us to contact you quickly. Email addresses or URLs of contact pages work well.
その他のAPI
For the REST API included with MediaWiki 1.35 and later, see the MediaWiki Core REST API.
API | Availability | URL base | 例 |
---|---|---|---|
MediaWiki 操作 API | MediaWiki に同梱されています
ウィキメディアのプロジェクト群で有効になっています |
/api.php | https://ja.wikipedia.org/w/api.php?action=query&prop=info&titles=地球 |
MediaWiki REST API | MediaWiki 1.35 以降に同梱されています
ウィキメディアのプロジェクト群で有効になっています |
/rest.php | https://ja.wikipedia.org/w/rest.php/v1/page/地球 |
ウィキメディア REST API | MediaWiki に同梱されていません
ウィキメディアのプロジェクト群のみで利用できます |
/api/rest | https://ja.wikipedia.org/api/rest_v1/page/title/地球 |
For commercial-scale APIs for Wikimedia projects, see Wikimedia Enterprise |
関連項目
- RESTBase, which is being deprecated, the technology behind the REST API
- Blog post announcing the 1.0 release. Describes several important production use cases, discusses how the REST API fits into Wikimedia's larger technical strategy, and provides pointers to some implementation details.
- The API is implemented using Node.js. This blog post describes our experience upgrading the REST API and other services to Node 6.
- MediaWiki Platform Team, product owners for the REST API.
- Core Platform Team/Initiatives/API Gateway (2020)