Skip to content

Les API

Walter De Maria, Art by Telephone, 1967 (installation view, When Attitudes Become Form -  Bern 1969/Venice 2013, Fondazione Prada, Venice)
Walter De Maria, Art by Telephone, 1967 (installation view, When Attitudes Become Form - Bern 1969/Venice 2013, Fondazione Prada, Venice)→ Ouvrir le lien
html
https://api.wikimedia.org/core/v1/wikipedia/en/search/title?q=water&limit=20

ou

html
https://api.open-meteo.com/v1/forecast?latitude=50.8503&longitude=4.3517&current_weather=true

ou encore Artpress

html
https://www.artpress.com/wp-json/wp/v2/posts

Les API, pour Application Program Interface, sont des interfaces qui permettent à plusieurs applications de communiquer entre elles, selon certaines règles. Généralement, cela fonctionne sur le modèle requête-réponse, la requête étant une requête HTTP (sous la forme d'une URL) et la réponse étant bien souvent au format JSON.

De nombreuses données sont disponibles en ligne. Par exemple, le gestionnaire de contenus Wordpress possède une API qui est active par défaut. Ce qui vous permet, pour la plupart des sites fonctionnant avec cette plateforme, de récupérer les données du site public sous la forme d'un arbre JSON pour en faire quelque chose d'autre (si vous en avez le droit).

C'est le cas de digitalab.be ou de artpress.com

html
https://www.artpress.com/wp-json/wp/v2/posts

Chaque API aura sa propre documentation avec ses propres règles de fonctionnement. Bien souvent, pour pouvoir utiliser une API, même si l'accès est gratuit, vous devrez vous créer un compte. Cela leur permet de limiter les appels afin de ne pas saturer les serveurs avec, entre autres, des bots. Mais ce n'est pas toujours le cas (voir ci-dessous, ou ici)

Voici la réponse d'OpenWeatherMap :

json
// API call: https://api.openweathermap.org/data/2.5/weather?lat=50.6392193&lon=4.020395&appid=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

{
    "coord": {
        "lon": 4.0204,
        "lat": 50.6392
    },
    "weather": [
        {
            "id": 701,
            "main": "Mist",
            "description": "mist",
            "icon": "50n"
        }
    ],
    "base": "stations",
    "main": {
        "temp": 282.6,
        "feels_like": 280.95,
        "temp_min": 282.29,
        "temp_max": 283.42,
        "pressure": 1026,
        "humidity": 95
    },
    "visibility": 9000,
    "wind": {
        "speed": 3.09,
        "deg": 190
    },
    "clouds": {
        "all": 75
    },
    "dt": 1706200037,
    "sys": {
        "type": 2,
        "id": 2016897,
        "country": "BE",
        "sunrise": 1706167785,
        "sunset": 1706199727
    },
    "timezone": 3600,
    "id": 2785321,
    "name": "Trahison",
    "cod": 200
}

Une requête via la Wikimedia Commons API peut ressembler à ceci:

js
https://commons.wikimedia.org/w/api.php?action=query&list=search&srnamespace=6&srsearch=%22forest%22&srlimit=5&format=json

// Ou ceci

https://api.wikimedia.org/core/v1/wikipedia/en/search/title?q=earth&limit=10

La documentation se trouve ici:

Un exemple de page que vous pourriez créer à partir d'un simple requête
Un exemple de page que vous pourriez créer à partir d'un simple requêteLa réponse au format JSON