Interface de programmation/Services Web

Un livre de Wikibooks.

Utiliser un service Web via son interface de programmation consiste à utiliser les ressources fournies sur demande par divers sites Internet.

Par exemple vous pouvez demander aux serveurs de Wikipédia des informations concernant tel ou tels sujets dans tel format de données.

Autre exemple vous pouvez demander aux serveurs de Google tel ou tel graphique.


Puzzle.svg
Ébauche

Cette page est considérée comme une ébauche à compléter. Si vous possédez quelques connaissances sur le sujet, vous pouvez les partager en éditant dès à présent cette page (en cliquant sur le lien « modifier »).

Ressources suggérées : Aucune (vous pouvez indiquer les ressources que vous suggérez qui pourraient aider d'autres personnes à compléter cette page dans le paramètre « ressources » du modèle? engendrant ce cadre)

[modifier] Exemple

[modifier] Wikipedia

L'interface de programmation du service web Wikipédia francophone est disponible ici : http://fr.wikipedia.org/w/api.php


Tools clipart.png Obtenir les informations à propos de la dernière révision de la page Accueil :

api.php ? action=query & prop=info|revisions & titles=Accueil

<?xml version="1.0"?>
<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page pageid="15169" ns="0" title="Accueil" touched="2009-05-10T14:43:08Z" lastrevid="229318" counter="0" length="1878">
        <revisions>
          <rev revid="229318" minor="" user="Savant-fou" timestamp="2009-04-25T16:07:37Z" comment="Ajout rapide de la catégorie [[Catégorie:Accueil|Accueil]] (avec [[MediaWiki:Gadget-HotCats.js|HotCats]])" />
        </revisions>
      </page>
    </pages>
  </query>
</api>

À l'écriture de ces lignes le 17 mai 2009, le dernier réviseur de la page Accueil était Savant-fou (d · c · b) - cette information est contenue dans la chaîne « user="Savant-fou" » - qui, le 25 avril 2009 à 16:07, a résumé sa modification par le commentaire « Ajout rapide de la catégorie (avec HotCats) ». Pour connaître le dernier réviseur de la page d'accueil en ce moment, cliquez sur le lien ci-dessus qui affiche ce document XML.


résultat de commandes dans différents formats
Tools clipart.png XML

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=xmlfm

<?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>
Tools clipart.png JSON

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=jsonfm

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

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=yamlfm

---
query: 
  pages: 
    - 
      pageid: 736
      ns: 0
      title: Albert Einstein
      touched: |
        2008-03-16T04:59:39Z
      lastrevid: 198568286
      counter: 4698
      length: 81076
Tools clipart.png WDDX

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=wddxfm

<?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>
Tools clipart.png PHP (serialized format, with line breaks added for readability. Use PHP's unserialize() function to recover data.)

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=php

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;}}}}
Tools clipart.png PHP (var_export format. Use PHP's eval() function to recover data.)

api.php ? action=query & titles=Albert%20Einstein & prop=info & format=dbg

array (
  'query' => 
  array (
    'pages' => 
    array (
      736 => 
      array (
        'pageid' => 736,
        'ns' => 0,
        'title' => 'Albert Einstein',
        'touched' => '2008-10-11T20:27:04Z',
        'lastrevid' => 244636163,
        'counter' => 4698,
        'length' => 89641,
      ),
    ),
  ),
)
 
Pour aller plus loin voir : mw:API/fr ou, pour la manipuler en deux minutes, voir interface de Wikipédia pour programmer.

[modifier] Google charts

Est disponible ici : http://chart.apis.google.com/chart?

Exemples d'utilisation : lignes - barres

Récupérée de « http://fr.wikibooks.org/wiki/Interface_de_programmation/Services_Web »