Identifier le rôle d'une API web et lire une réponse structurée au format JSON

En 30 secondes

• Une API permet à un programme d'envoyer une requête HTTP à un endpoint et de recevoir une réponse, le plus souvent au format JSON, sans page web affichée pour un humain.
• Le JSON organise les données en paires clé-valeur, regroupées dans des objets { } ou des tableaux [ ] d'objets.
• Un code de statut HTTP (200 = réussite, 404 = ressource introuvable) indique si la requête a réussi avant même de lire les données JSON.

Ce que tu sauras faire

• Tu sauras expliquer à quoi sert une API web et pourquoi elle permet à des programmes d'échanger des données sans passer par une page affichée pour un humain.
• Tu sauras repérer, dans une réponse JSON, les paires clé-valeur, les objets et les tableaux qui la structurent.
• Tu sauras compter et additionner des valeurs numériques lues dans une réponse JSON pour répondre à une question posée sur ces données.
• Tu sauras associer un code de statut HTTP à ce qu'il signifie pour l'exploitation d'une réponse d'API.

Les mots à connaître

API

l'abréviation d'Application Programming Interface (interface de programmation), un ensemble de règles qui permet à un programme d'envoyer une requête à un service web et d'en recevoir une réponse, sans passer par une page affichée pour un humain.

Endpoint

l'adresse précise d'une API à laquelle un programme envoie sa requête pour obtenir une ressource ou une donnée particulière.

Client

l'appareil ou le programme qui envoie une requête à un serveur pour demander une ressource ou une donnée.

Le piège classique

Confondre un objet JSON (accolades { }, une paire clé-valeur par élément) et un tableau JSON (crochets [ ], plusieurs objets à la suite) — le nombre de paires clé-valeur d'un objet et le nombre d'objets d'un tableau ne se comptent pas de la même façon.

L'astuce

API = programme qui parle à un programme, sans page web affichée pour un humain.