Wikimedia REST API/pt
A REST API da Wikimedia oferece acesso ao conteúdo e aos metadados da Wikimedia em formatos compreensíveis. Focado em casos de uso de alto volume, ele se integra perfeitamente à infraestrutura de cache distribuída globalmente da Wikimedia. Como resultado, os usuários da API se beneficiam de latências reduzidas e suporte para grandes volumes de solicitações.
A API REST, juntamente com sua documentação, está disponível para todos os principais projetos da Wikimedia no local /api/rest_v1/. Por exemplo, para a Wikipédia em inglês está disponível por https://en.wikipedia.org/api/rest_v1/.
Embora a funcionalidade oferecida pela maioria dos projetos seja semelhante à da Wikipedia em inglês, existem algumas exceções dignas de nota:
- wikimedia.org oferece informações entre projetos, como métricas de visualização de página.
- en.wiktionary.org oferece um ponto final de definição experimental, expondo informações do Wikcionário como dados estruturados. O suporte para outros idiomas (em discursão).
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.
Other APIs
Para a API REST incluída no MediaWiki 1.35 e posterior, consulte a API REST do MediaWiki Core.
API | Availability | URL base | Example |
---|---|---|---|
MediaWiki Action API | Included with MediaWiki
Enabled on Wikimedia projects |
/api.php | https://en.wikipedia.org/w/api.php?action=query&prop=info&titles=Earth |
MediaWiki REST API | Included with MediaWiki 1.35+
Enabled on Wikimedia projects |
/rest.php | https://en.wikipedia.org/w/rest.php/v1/page/Earth |
Wikimedia REST API | Not included with MediaWiki
Available for Wikimedia projects only |
/api/rest | https://en.wikipedia.org/api/rest_v1/page/title/Earth |
For commercial-scale APIs for Wikimedia projects, see Wikimedia Enterprise |
See also
- 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)