API:Data formats/fr

From MediaWiki.org

Jump to: navigation, search
Tools clipart.png Cette page fait partie de la documentation de l'API de MediaWiki.
API de MediaWiki


L'API de MediaWiki supporte un certain nombre de formats génériques (XML, JSON, YAML, ...) et certains formats spécifiques (RSS, ...) pour certains modules.

Sauf indication contraire, les modules supportent tous les formats. Pour la simplification du débogage, certains formats ont une version HTML avec un suffixe 'fm'. Par défaut le format xmlfm est utilisé.

Code Description Paramètres
json format JSON callback (opt): renvoie le contenu dans un wrappeur donné
jsonfm format JSON (HTML) callback (opt): renvoie le contenu dans un wrappeur donné
php format PHP sérialisé
phpfm format PHP v (HTML)
wddx format WDDX
wddxfm format WDDX (HTML)
xml format XML
xmlfm format XML (HTML) (par défaut)
yaml format YAML
yamlfm format YAML (HTML)
rawfm format JSON avec des éléments de déboguage (HTML) callback (opt): renvoie le contenu dans un wrappeur donné

[edit] Examples

XML

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein" touched="2007-07-06T04:37:30Z" lastrevid="142335140" counter="4698" length="86906" />
    </pages>
  </query>
</api>

JSON

{
    "query": {
        "pages": {
            "736": {
                "pageid": 736,
                "ns": 0,
                "title": "Albert Einstein",
                "touched": "2007-07-06T04:37:30Z",
                "lastrevid": 142335140,
                "counter": 4698,
                "length": 86906
            }
        }
    }
}

YAML

---
query: 
  pages: 
    - 
      pageid: 736
      ns: 0
      title: Albert Einstein
      touched: 2007-07-06T04:37:30Z
      lastrevid: 142335140
      counter: 4698
      length: 86906

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="736">
                <struct>
                  <var name="pageid">
                    <number>736</number>
                  </var>
                  <var name="ns">
                    <number>0</number>
                  </var>
                  <var name="title">
                    <string>Albert Einstein</string>
                  </var>
                  <var name="touched">
                    <string>2007-07-06T04:37:30Z</string>
                  </var>
                  <var name="lastrevid">
                    <number>142335140</number>
                  </var>
                  <var name="counter">
                    <number>4698</number>
                  </var>
                  <var name="length">
                    <number>86906</number>
                  </var>
                </struct>
              </var>
            </struct>
          </var>
        </struct>
      </var>
    </struct>
  </data>
</wddxPacket>

PHP (avec un saut de ligne pour la lisibilité)

a:1:{s:5:"query";a:1:{s:5:"pages";a:1:{i:736;a:7:{s:6:"pageid";i:736;s:2:"ns";i:0;s:5:"title";s:15:"Albert Einstein";
s:7:"touched";s:20:"2007-07-06T04:37:30Z";s:9:"lastrevid";i:142335140;s:7:"counter";i:4698;s:6:"length";i:86906;}}}}