API Star Wars

Présentation

SWAPI est une API très organisée et complète, qui combine les données des 7 premiers films Star Wars (pour le moment jusqu'au Réveil de la Force).

On peut y trouver des infos sur :

Les personnages
Les films
Les véhicules
Les vaisseaux
Les planètes
Les races

Voici le lien : https://swapi.co/

Points d'accès de l'API

Pour commencer, voici le lien de la documentation de l'API : https://swapi.co/documentation

Cette API possède plein de points d'accès, organisés en fonction des types de données cités plus haut : les films, planètes etc ;)

Le point d'accès Root

Le point d'accès Root contient les liens de tous les autres points d'accès.

C'est un peu le point de départ de l'API si on veut :)

Voici son lien sur la doc : https://swapi.co/documentation#root

Voici la liste de tous les autres points d'accès de SWAPI, comme montré sur Root.

Chacun de ces liens envoie vers la liste complète des ressources qu'il contient. Si on fait une requête sur le lien des people, on aura donc la liste de tous les personnages... Enfin presque ;)

Exemple sur le point d'accès People

Le point d'accès People se trouve à ce lien sur la doc : https://swapi.co/documentation#people

Chaque point d'accès de SWAPI contient :

Les variantes de requêtes qu'on peut faire dessus
Un exemple de requête
Un exemple de réponse reçue depuis une requête
La liste de tous les attributs contenus dans une requête sur ce point d'accès

Ici, sur le point d'accès People, on peut faire les requêtes suivantes :

/people/, ce qui nous envoie toutes les ressources sur les personnages
/people/:id/, ce qui nous envoie les infos d'un seul personnage.
/people/schema/, qui est juste un exemple de formattage donné en réponse d'une requête. Ce dernier ne nous intéressera pas :)

Enfin, en dessous de l'exemple, tu trouveras la liste des attributs de la ressource que tu as demandé !

Par exemple, pour les personnages, tu peux récupérer toutes les infos listées sur l'image de gauche ! :D Et ça c'est seulement pour les personnages... ;)

A chaque fois qu'il y aura une info qui dépend d'un autre point d'accès de l'API, des liens t'y donnant accès te seront donnés.

Par exemple, pour Luke Skywalker, la donnée homeworld contient le lien de l'API qui contient les infos de Tatooine, et la donnée films contient un tableau des liens de l'API de tous les films dans lequel Luke fait une apparition :)

Si on fait bien attention, on verra que la requête sur https://swapi.co/api/people nous envoie bien des infos sur les personnages (entourés en vert), mais si on va jusqu'en bas du résultat de la requête, on verra qu'on n'en a que 10.

En réalité, l'API est ordonnée par pages de 10 ressources ! Chaque fois qu'on demande la liste de toutes les ressources d'un point d'accès, l'API nous enverra donc la première page de ces ressources :)

Ceci dit, si on regarde bien au tout début de ce résultat, on verra un lien "next", qui contient... la page suivante (entouré en bleu) ! :D L'astuce, si on veut parcourir tous les personnages (par exemple !), c'est de récupérer le lien de la page suivante à chaque fois, et de refaire une requête sur la page d'après :)

Tu trouveras la marche à suivre en code dans les exemples en dessous ;)

Exemples

Ces codes exemples sont les différentes évolutions d'un programme consistant à récupérer tous les personnages et à afficher des informations sur eux.

Ils sont classés de la version la plus simple à la plus complexe :)

Facile - Afficher les noms de tous les persos

Moyen - Afficher certaines infos de tous les persos

Difficile - Afficher les stats de tous les persos les plus importants de Star Wars

Report abuse