API:REST API/Policies

This page provides links to usage and stability policies for the MediaWiki REST API.

Access and usage policies

Client identification and authorization

All API requests must include an HTTP User-Agent header. See the User-Agent policy for details and instructions.

The REST API uses the OAuth 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.

Rate limits

The MediaWiki REST API is governed by Wikimedia Foundation API Usage Guidelines and Robot policy. For tips to optimize your requests, see the Getting Started page.

Content attribution and reuse

Wikimedia content is free to reuse within the terms specified by the applicable license. Licenses can differ between projects, so see the individual project for information about licenses and content reuse. For more information about licensing and trademark use, see Developer App Guidelines.

Stability policy

The MediaWiki REST API is versioned using a global version number in the API path (for example: /v1/).

For additional details about how versions and deprecations are managed for this API, see API/Deprecation.

Changelog

See API:REST API/Changelog.