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 :
Voici le lien : https://swapi.co/
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 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 ;)
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 :
Ici, sur le point d'accès People, on peut faire les requêtes suivantes :
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 ;)
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 :)