API:Data formats/es

From MediaWiki.org

Jump to: navigation, search
Tools clipart.png Esta página es parte de la documentación de la API MediaWiki.
API de MediaWiki


La API MediaWiki suporta varias formatos de salida genéricos (XML, JSON, YAML, etc.), y algunos foratos específicos al dominio (RSS, etc.) para módulos especiales.

Salvo indicación contraria, todos los módulos permiten la salida de datos en todos los formatos genéricos. Para simplificar el debugging, todos los formatos genéricos tienen una alternativa "pretty-print en HTML" con el sufijo 'fm'. Por defecto se usa el formato 'xmlfm'.

Código Descripción Parámetros
json formato JSON callback (opt): Wraps the output into a given function call
jsonfm formato JSON (HTML) callback (opt): Wraps the output into a given function call
php Formato serializado de PHP
phpfm Formatoserializado de PHP (HTML)
wddx formato WDDX
wddxfm formato WDDX (HTML)
xml formato XML
xmlfm format XML (HTML) (por defecto)
yaml formato YAML
yamlfm formato YAML (HTML)
rawfm format JSON con elementos de debugging (HTML) callback (opt): Wraps the output into a given function call
txt Formato de la función print_r() de PHP
txtfm Formato de la función print_r() de PHP (HTML)
dbg Formato de la función var_export() de PHP
dbgfm Formato de la función var_export() de PHP (HTML)

[edit] Ejemplos

XML

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="53" ns="0" title="Albert Einstein" touched="2008-05-21T17:34:31Z" lastrevid="17549470" counter="1390" length="38912" />
    </pages>
  </query>
</api>

JSON

{
    "query": {
        "pages": {
            "53": {
                "pageid": 53,
                "ns": 0,
                "title": "Albert Einstein",
                "touched": "2008-05-21T17:34:31Z",
                "lastrevid": 17549470,
                "counter": 1390,
                "length": 38912
            }
        }
    }
}

YAML

---
query:
  pages:
    -
      pageid: 53
      ns:
      title: Albert Einstein
      touched: |
        2008-05-21T17:34:31Z
      lastrevid: 17549470
      counter: 1390
      length: 38912

WDDX

<?xml version="1.0" encoding="utf-8"?>
<wddxPacket version="1.0">
  <header/>
  <data>
    <struct>
      <var name="query">
        <struct>
          <var name="pages">
            <struct>
              <var name="53">
                <struct>
                  <var name="pageid">
                    <number>53</number>
                  </var>
                  <var name="ns">
                    <number>0</number>
                  </var>
                  <var name="title">
                    <string>Albert Einstein</string>
                  </var>
                  <var name="touched">
                    <string>2008-05-21T17:34:31Z</string>
                  </var>
                  <var name="lastrevid">
                    <number>17549470</number>
                  </var>
                  <var name="counter">
                    <number>1390</number>
                  </var>
                  <var name="length">
                    <number>38912</number>
                  </var>
                </struct>
              </var>
            </struct>
          </var>
        </struct>
      </var>
    </struct>
  </data>
</wddxPacket>

PHP (con un fin de línea agregado para mayor legibilidad)

a:1:{s:5:"query";a:1:{s:5:"pages";a:1:{i:53;a:7:{s:6:"pageid";i:53;s:2:"ns";i:0;s:5:"title";s:15:"Albert Einstein";
s:7:"touched";s:20:"2008-05-21T17:34:31Z";s:9:"lastrevid";i:17549470;s:7:"counter";i:1390;s:6:"length";i:38912;}}}}