API:Main page/es

 Atención visitantes

Esta página describe el permanente esfuerzo para proveer una API estable para el acceso conveniente a datos de MediaWiki legibles por máquinas.

Actualmente, MediaWiki dispone de cuatro (4) interfaces:
 * MediaWiki API - la nueva API descrita en estas páginas;
 * La página especial Exportar (exporta artículos en formato xml);
 * La interfaz común, basada en la web.

El servicio web del API de MediaWiki ofrece un fácil acceso a articulos wiki, datos y metadatos.

Introducción
Esta puede ser usada como guía en una instalación de MediaWiki, o para crear un robot (bot) para mantenimiento automatico. Se provee un directo acceso a nivel alto a la información contenida en las bases de datos de MediaWiki. Los programas clientes pueden registrarse en un wiki, obtener información, y publicar cambios automaticamente al hacer una petición HTTP al servicio web. Las aplicaciones permitidas incluyen robots (bots), pequeños programas clientes basados en web de Javascript como son Popups de Navegacion y LiveRC, aplicaciones independientes (como vandal fighter), y por otros sitios web (utilidades Toolserver ).

En instalaciones nuevas de MediaWiki, el servicio web esta habilitado predeterminadamente, pero un administrador puede desactivarla.

MediaWiki tiene dos nuevas interfaces de salida:


 * La pagina Special:Export, que provee una exportación masiva del contenido wiki hacia XML. Lee el articulo de ayuda de Export en meta.wikimedia.org para mas información.
 * La interfaz basada en web estandar (que tu podrias estar utilizando ahorita). Lee el Manual:Parameters to index.php para informarte del uso de interfaces basadas en web.

Un ejemplo sencillo
Esta URL manda una llamada al API del servicio web de Wikipedia en Ingles para que te devuelva el contenido de la pagina principal

 http://en.wikipedia.org/w/api.php?format=json&action=query&titles=Main%20Page&prop=revisions&rvprop=content

Usa cualquier lenguaje de programación para realizar una petición HTTP GET para esa URL (o solamente visita ese enlace en tu navegador), y tu obtendras un documento JSON que incluye el actual wiki de la pagina titulada "Main Page". Cambiando el formato a jsonfm regresara un HTML "identado" como buen resultado al depurar.

En el menú de la derecha puedes acceder a las distintas secciones de esta documentación.

El objetivo de esta API es proveer acceso directo y de alto nivel a los datos contenidos en las bases de datos de MediaWiki. Los programas clientes pueden usar la API para loguearse, obtener datos y enviar cambios. La API soporta clientes JavaScript basados en la web (como o ),

Todas las salidas están disponibles en un amplio rango de formatos.

Cada módulo de la API emplea un conjunto de parámetros. Para prevenir la colisión de nombres, cada submódulo de action=query (llamados submódulos de consulta) tiene una abreviatura de dos letras, y el nombre de cada parámetro comienza con esas dos letras a modo de prefijo.


 * Puede obtener una breve ayuda y guía de parámetros de la API misma;
 * Lista de correo para notificaciones y preguntas: Lista de correo API;
 * Ver y reportar bugs (errores) de la API: BugZilla (cuando reporte nuevos errores, no se olvide de especificar Component=API).

Enlaces útiles

 * código fuente del API en SVN;
 * Database layouten;
 * El esquema de la base de datos actual en SVN.

Archivo

 * Discusión sobre la API en Wikimanía 2006en