Wikimedia REST API/es
La API REST de Wikimedia ofrece acceso al contenido y a los metadatos de Wikimedia en formatos legibles por máquinas. Centrada en los casos de uso de gran volumen, se integra estrechamente con la infrestructura de caché distribuida globalmente de Wikimedia. Como resultado de ello, los usuarios de la API se benefician de latencias reducidas y del soporte para altos volúmenes de peticiones.
La API REST, junto con su documentación, está disponible para todos los principales proyectos de Wikimedia en la ruta /api/rest_v1/. Por ejemplo, en Wikipedia en inglés, se encuentra en https://en.wikipedia.org/api/rest_v1/.
Aunque la funcionalidad ofrecida por la mayoría de los proyectos corresponde estrechamente a la de Wikipedia en inglés, hay algunas excepciones notables:
- wikimedia.org ofrece información entre proyectos como métricas de visualizaciones de páginas.
- en.wiktionary.org ofrece un punto de acceso experimental de definiciones que expone información del Wikcionario en forma de datos estructurados. Hay una discusión en curso acerca del soporte para otros idiomas.
Versionado
La API REST sigue esta política de versionado para API.
Términos y condiciones
- Al utilizar la API REST, aceptas las Condiciones de Uso generales y la Política de Privacidad de Wikimedia.
- Para evitar afectar a otros usuarios de la API, limita tus clientes a no más de 200 peticiones/segundo totales a esta API. Muchos puntos de acceso especifican y aplican adicionalmente límites más restrictivos.
- Te pedimos que establezcas una cabecera
User-Agent
oApi-User-Agent
que nos permita contactar rápidamente contigo. Las direcciones de correo electrónico y las URL de páginas de contacto funcionan bien.
Otras API
Para la API REST incluida con MediaWiki 1.35 y posteriores, consulta API REST del núcleo de MediaWiki.
API | Availability | URL base | Example |
---|---|---|---|
![]() |
Included with MediaWiki
Enabled on Wikimedia projects |
/api.php | https://en.wikipedia.org/w/api.php?action=query&prop=info&titles=Earth |
![]() |
Included with MediaWiki 1.35+
Enabled on Wikimedia projects |
/rest.php | https://en.wikipedia.org/w/rest.php/v1/page/Earth |
![]() |
Not included with MediaWiki
Available for Wikimedia projects only |
/api/rest | https://en.wikipedia.org/api/rest_v1/page/title/Earth |
![]() |
Véase también
- RESTBase, en proceso de pérdida de vigencia, la tecnología detrás de la API REST
- Publicación de blog que anuncia el lanzamiento de la versión 1.0. Describe una serie de casos de uso importantes de producción, describe cómo encaja la API REST en la estrategia técnica general de Wikimedia y proporciona indicaciones para algunos detalles de implementación.
- La API está implementada mediante Node.js. Esta publicación de blog describe nuestra experiencia de la actualización de la API REST y otros servicios a Node 6.
- Equipo de la Plataforma MediaWiki, propietarios de producto de la API REST.
- Core Platform Team/Initiatives/API Gateway (2020)