API:REST API/es

La REST API de MediaWiki te permite interactuar con MediaWiki enviando solicitudes HTTP a URLs. Puedes usar API para construir aplicaciones y secuencias de comandos (scripts) que buscan y muestran páginas wiki, obtienen archivos multimedia y exploran el historial de una página.



Guía rápida
$ curl



Formato de datos
Los puntos finales de la REST API devuelven datos en formato JSON o HTML. Véase la referencia API para el tipo de contenido admitido por cada punto final.

Métodos
La API soporta métodos de petición HTTP estándares.



Estructura URL
Los puntos finales de API comparten una estructura URL consistente que incluye la URL base del wiki, la ruta del script y la versión de API.

Versionado
Diseñado para proveer estabilidad a largo plazo para desarrolladores, la REST API de MediaWiki está versionada usando un número de versión global en la ruta de API (por ejemplo: ). Siguiendo los principios del versionado semántico, la versión es incrementada cuando un endpoint es modificado de manera incompatible con versiones anteriores, como por ejemplo la eliminación de una propiedad de respuesta o adición de un parámetro requerido. Dentro de una versión mayor, la API puede cambiar de maneras compatibles con versiones anteriores, como por ejemplo la adición de una propiedad de respuesta o un parámetro opcional.



Permisos y autorización
La REST API está diseñada para ser utilizada con la extensión para autenticación y autorización de usuarios. De todas formas, independientemente del método de autenticación, la API responde a la presencia de un usuario con sesión iniciada y devuelve contenido apropiado a los permisos del usuario.



Acceder proyectos Wikimedia usando la REST API
Puedes usar la REST API para acceder Wikipedia, Wiktionary, y otros proyectos Wikimedia en múltiples idiomas. Para una lista completa de URLs de proyectos Wikimedia, véase La matriz de sitios de Meta-Wiki



Límite de solicitudes
No hay un límite fijo de solicitudes a la API, pero tu cliente puede ser bloqueado si pones la estabilidad del sitio en peligro. Para mantenerte dentro de una tasa de solicitudes segura, espera a que cada solicitud termine antes de enviar una nueva.



Identificación del cliente
Los sitios de Wikimedia requieren una cabecera User-Agent para todas las solicitudes a la API. Esto ayuda a identificar tu aplicación y garantiza que los administradores del sistema puedan contactarte si surge un problema. Los clientes que hagan solicitudes sin una cabecera User-Agent podrán ser bloqueados por IP sin previo aviso.

La cabecera User-Agent puede incluir una página de usuario en la wiki local, una página de usuario en una wiki relacionada usando sintaxis de enlaces interwiki, una URL a un sitio web relevante, o un correo electrónico.

Si estás llamando a la API desde JavaScript basado en el navegador, es posible que no puedas influir en el encabezado de $1, dependiendo del navegador. To work around this, use the   header. See Meta-Wiki’s User-Agent policy for more information.

Authorization
To authorize your app to act on behalf of a user, follow the OAuth developer guide to register your app and make requests using OAuth tokens.

Licensing and trademarks
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 example, English Wikipedia’s text can be used under the terms of the Creative Commons Attribution Share-Alike license, while media files on Wikimedia Commons are licensed individually as indicated on the file’s information page. For more information about licensing and trademark use, see Meta-Wiki’s developer app guidelines.

Limitations on Wikidata
While the REST API is available on Wikimedia projects, it is not fully supported by Wikidata. As of writing, some of the endpoints may return unexpected errors.

Extension endpoints
MediaWiki extensions can surface extension-specific API endpoints using the REST API interface. See the REST API extension interface docs to get started. For documentation for REST API endpoints provided by extensions, see the extension docs. The REST API extension interface is available in via  and in  and later by default.

About these docs
These docs are written manually based on the. Corrections and additions are welcome! To share a tutorial or app that uses the MediaWiki REST API, add a link to the REST API template.