Marvel a rendu disponible récemment une API publique et un service REST qui donnent accès aux métadonnées de leurs bandes dessinées.
Roberto Medrano, Vice-Président Exécutif à SOA Software, considère que les APIs web verront une "adoption massive" en 2014 et les années suivantes. Non seulement les APIs facilitent le développement d'applications mobiles, mais mobile et cloud sont une combinaison gagnante : "Lorsque les APIs fonctionnent à travers le cloud, leur capacité de connecter et de délivrer est rendue exponentiellement plus aisée que de le réaliser à travers des plateformes traditionnelles". De même, les centres de données exploitant des logiciels vont se baser sur des APIs, "L'Internet des Objets va devenir l'API des Objets", SOA et les APIs seront de plus en plus appréhendés comme complémentaires, et même REST va évoluer à travers la contribution de "nouveaux standards comme WADL, Swagger, RAML et d'autres, en raison de leur flexibilité, et vont combler des manques laissés par REST et des déficiences qu'il a dans la définition de la description des services", d'après Medrano.
Rien d'étonnant à ce que même les bandes dessinées Marvel et les personnages puissent être maintenant accédés à travers une API publique. Au-delà de l'attraction d'un point de vue du divertissement, l'API Marvel Comics est un exemple de conception d'une API web. Marvel exécute un service REST fournissant des réponses JSON aux requêtes HTTP, les points de connexion ne supportant uniquement que le verbe GET.
Les ressources de l'API Marvel sont :
- Bandes dessinées : numéros imprimés et numériques, collections et nouvelles graphiques. Par exemple : Amazing Fanzasy #15
- Séries : groupes de bandes dessinnées numérotées séquentiellement (pour la plupart). Par exemple : Uncanny X-Man
- Histoires : composants indivisibles et réutilisables des bandes dessinées. Par exemple, la couverture d'Amazing Fantasy #15 ou l'histoire de l'origine de Spider-Man dans cette bande dessinée
- Evènements et crossovers : épopées qui changent l'univers. Par exemple, Infinity
- Créateurs : les hommes, les femmes et les organizations qui créent les bandes dessinées. Par exemple, Jack Kirby
- Personnages : les hommes, les femmes, les organisations, les espèces extra-terrestres, les déités, les animaux, les entités non-corporelles, les manifestations trans-dimensionelles, les personifications abstraites et les blobs verts et amorphes qui occupent l'Univers Marvel (donc les univers parallèles, les lignes temporelles et les réalités alternatives qui en font partie). Par exemple, Spider-Man
Voici un exemple d'une requête pour le groupe des Vengeurs :
http://gateway.marvel.com:80/v1/public/characters/1009165?apikey=xxxxx
Et la réponse raccourcie est la suivante :
{
"code": 200,
"status": "Ok",
"etag": "e52e95f71334d797c3c2d0cf144bcc3e611718db",
"data": {
"offset": 0,
"limit": 20,
"total": 1,
"count": 1,
"results": [
{
"id": 1009165,
"name": "Avengers",
"description": "Earth's Mightiest Heroes joined forces to take on threats
that were too big for any one hero to tackle.
With a roster that has included Captain America, Iron Man, Ant-Man, Hulk, Thor, Wasp
and dozens more over the years, the Avengers have come to be regarded as Earth's No. 1 team.",
…
}
]
}
}
L'API Marvel Comics supporte l'authentification, le versionage, la récupération de collections de ressources ou d'une ressource spécifiée par son ID, les requêtes cross-origin, la compression et les ETags utilisés pour éviter de calculer une réponse deux fois si son contenu n'a pas changé depuis la première requête. La base de données comprend une large collection d'images comme celles affichées ci-dessus, qui a été récupérée en utilisant le chemin fourni dans la réponse des Vengeurs. Les développeurs sont limités à 1 000 appels/jour.
L'ebook d'Apigee "La conception d'API Web : Fournir des Interfaces que les Développeurs Aiment" fournit une aide détaillée sur la conception d'API Web.