REST

Les API (Application Programming Interface) Web sont un moyen d'inter-connecter des programmes entre eux. Par exemple, je peux écrire un programme qui analyse les tweets en utilisant l'API offerte par twitter. Pour utiliser une API Web, il faut généralement comprendre plusieurs notions comme JSON, REST, ...

JSON

JavaScript Object Notation est un format largement utilisé pour échanger des données sur le Web. Exemple de JSON :

{
	"id": 1,
	"firstname": "Luke",
	"name": "Skywalker",
	"email": "[e-mail]"
}

Aller plus loin sur JSON :

• https://restfulapi.net/introduction-to-json/

• Valider du code JSON : https://jsonlint.com.

API

Application programming interface est un ensemble de règles permettant à des programmes de communiquer entre eux. Le développeur créé une API sur le serveur afin que les clients puissent communiquer avec ce dernier.

REST

Representational State Transfer définit des règles pour structurer une API Web. Par exemple, les ressources (données) sont accessibles via une URL spécifique (endpoint).

Introduction aux APIs REST :

• https://restfulapi.net/

• https://www.smashingmagazine.com/2018/01/understanding-using-rest-api/

API RESTful :

• chaque ressource est identifiée et accessible via une URI

• les traitements (CRUD) à appliquer sont décrits par les verbes HTTP (GET, POST, ...)

Exemple d'API RESTful pour gérer des tâches

Exemples de documentation d'API : https://punkapi.com/documentation/v2

Documenter et tester une API est important et il existe des outils pour cela comme https://swagger.io. Mais nous n'aborderons pas cela dans ce cours.

Exemples d'API

• Public Web API

• https://imdb-api.com/ cette API Web permet d'accéder aux données d'IMDB (bases de données sur les films et séries). Il suffit de se créer un compte et on peut par exemple récupérer en JSON, les 250 meilleurs films (selon IMDB), ...

• https://pokeapi.co/

• https://punkapi.com/

• https://ladataverte.fr/

Exercice

Se connecter à l'API Web https://pokeapi.co/ Explorez l'API choisie en utilisant l'un des logiciels suivant :

• votre navigateur Web (requêtes GET)

• un plugin pour votre navigateur (exemple)

• https://reqbin.com/

• le logiciel Postman

Ecrire du code PHP qui se connecte à cette API, et affiche le résultat sous la forme d'un tableau dans une page Web.