J'aime les API qui sortent de l'ordinaire. Après vous avoir présenté une API permettant d'obtenir des informations sur les super-héros et super-vilains, voici une API sur le thème de l'univers Harry Potter.

Avant toute chose, pour pouvoir utiliser l'API Harry Potter, vous devez avoir une clé. Celle-ci ne s'obtient qu'en s'inscrivant sur le site.

Une fois votre clé obtenue, vous devrez la passer en argument de chaque appel à l'API avec le paramètre key.

L'API dispose de plusieurs ressources permettant d'obtenir beaucoup d'informations sur les personnages d'Harry Potter, les maisons et les sorts.

Voici l'URL pour lister tous les personnages :

https://www.potterapi.com/v1/characters?key=xxx

Par défaut, tous les personnages seront retournés. L'API dispose de autorise plusieurs paramètres afin de filtrer les résultats : house pour filtrer par maison, school, name, etc...

https://www.potterapi.com/v1/characters?key=xxx&house=Gryffindor

Si vous le connaissez, vous pouvez passer l'identifiant du personnage directement dans l'URL pour obtenir sa fiche :

https://www.potterapi.com/v1/characters/5a109af13dc2080021cd877a?key=xxx

Diverses informations sont présentes dans le retour de l'API telles que : le nom du personnage, son rôle, sa maison, son école, sa baguette, s'il fait parti de l'ordre du Phoenix, etc...

Concernant les maisons, l'URL suivante permet de les lister dans leur totalité :

https://www.potterapi.com/v1/houses?key=xxx

Au contraire des personnages, les maisons ne peuvent pas être filtrées.

L'API retourne les informations des maisons ainsi que la liste des membres associés, qui correspondent aux identifiants des personnages.

Comme pour les personnages, vous pouvez vous restreindre à une fiche d'une maison en particulier en lui passant son identifiant dans l'URL :

https://www.potterapi.com/v1/houses/5a05e2b252f721a3cf2ea33f?key=xxx

Cette fois-ci, les membres ont, en plus de leur identifiant, leur nom.

Enfin, l'API met à disposition la liste des sorts via l'URL suivante :

https://www.potterapi.com/v1/spells?key=xxx

Comme les autres ressources, vous pouvez passer l'identifiant dans l'URL pour avoir uniquement le sort souhaité :

https://www.potterapi.com/v1/spells/5b74f6613228320021ab62c0?key=xxx