Geek Test de l’API Marvel

Pour les rares lecteurs de ce blog qui l’ignoreraient encore, je suis abonnée à Marvel Unlimited, service permettant d’accéder à l’ensemble du catalogue de comics Marvel disponible en ligne. Et oui, c’est pour ça que les sections “En ce moment je lis” et “Récemment j’ai lu” à droite de ce blog sont souvent remplies de comics.

J’ai donc virtuellement des milliers de comics à ma disposition, sous mon appli Android (à peine buguée). Des milliers de comics, oui, mais pour avoir les nouveautés, il font patienter 6 mois après leur date de sortie, car Marvel donne la priorité à l’achat de comics à l’unité. Logique, on pourrait dire. Ce qui est moins logique, c’est que les utilisateurs de MU n’ont aucun moyen d’être notifiés lorsqu’une série qui les intéresse est (enfin) disponible. Il faut aller toutes les semaines sur le site de Marvel, consulter une page qui rame, ou bien une section pas très pratique “New this week” à scroller sur la page d’accueil de l’application.

Et c’est alors qu’entre en scène l’API Marvel !

Car sur le site officiel de Marvel, on trouve une section pour les développeurs. Autant dire que cette  section n’est pas très vivante : la dernière mise à jour de l’API date de 2014. Pire, la page pour obtenir une clé d’API est carrément buguée, on doit accepter des conditions d’utilisation… mais le bouton “submit” est en fait caché dans la page, il faut aller éditer le html à la main pour arriver à valider le formulaire… Bref, ça sent le projet bien maintenu ! Je ne parle pas de la section documentation, où là aussi, la section qui est sensé nous permettre d’interroger l’API en live est absente de la page…

Malgré tous ces signes encourageants, j’ai décidé de me lancer dans la conception d’une page web qui permettrait de faire appel à l’API pour afficher les derniers comics dispo sur MU. Etant donné l’absence de doc, j’ai dû pas mal tâtonner avec l’API pour arriver à trouver les paramètres permettant de récupérer uniquement les comics qui m’intéressaient. Et comme j’ai choisi de le faire en JavaScript, langage que je ne connais pas vraiment, heureusement que j’ai été aidée par Taz et Jiiieeef !

Mais le résultat final est plutôt sympa : vous pouvez rechercher des comics par titre et année de démarrage, et aussi des séries. Le résultat affiche la miniature des comics disponibles, avec un lien vers l’image, qui me sert pour l’ajouter ensuite à ma section “En ce moment je lis”, tant qu’à faire. Il y a possibilité d’avoir des liens directs vers les favoris, qui sont paramétrables via un fichier json, s’il vous plaît ! Si vous voulez avoir une idée du rendu, ça donne ça :

Et le code source est dispo sur mon superbe repo Gogs . J’attends vos reviews ! 😉

Comments are closed.