Marvel Comics API

Molti di noi sono cresciuti leggendo i fumetti, ma questa forma d'arte aveva poco a che vedere con la programmazione, almeno fino ad oggi. Infatti il team Marvel ha pubblicato le Marvel Comics API, che permettono agli sviluppatori di accedere ad un immenso database di informazioni riguardante proprio il mondo dei super eroi Marvel. Si tratta di un set di librerie che permette di cercare e di visualizzare l'albo corrispondente all'argomento che ci interessa, un supereroe oppure un autore in particolare.

Il team della famosa casa statunitense ha deciso di fornire una nuovo ventaglio di opzioni per gli sviluppatori di terze parti, al fine di presentare in modo ottimale le immagini agli utenti nelle varie applicazioni e nei portali web. L'API Marvel Comics non propone percorsi completi alle immagini, per ovvi motivi di copyright, ma tali contenuti sono rappresentati come un percorso parziale di un file immagine e dall'estensione canonica di quel file.

Gli sviluppatori possono scegliere tra una serie di varianti di immagine (dimensioni e rapporti predefiniti) cosi da impostare i contenuti al meglio per le esigenze della propria applicazione o del proprio sito Web.

Si tratta di un'API che sicuramente farà comodo agli store online o magari alle applicazioni che desiderano catalogare le propria libreria di fumetti, gli utenti dunque potranno cercare una determinata serie per visualizzare quali sono stati acquistati e quali, invece, sono ancora da acquistare.

La Marvel Comics API è rilasciata sotto licenza MIT, dunque può essere integrata senza problemi nei vari progetti open source. Installarla sul proprio sistema è molto semplice e possiamo sfruttare il comodo gestore di pacchetti npm:

npm i marvel-api

Una volta registrati come sviluppatori sul sito ufficiale di Marvel possiamo ottenere e usare la nostra chiave pubblica per sfruttare le API:

var api = require('marvel-api');
var marvel = api.createClient({
  publicKey: 'my-public-key'
, privateKey: 'my-private-key'
});

Con tale API è quindi possibile reperire i vari albi Marvel ricercando il nome del supereroe, gli eventi, gli autori, i filoni, ecc. Ad esempio:

marvel.characters.findByName('spider-man')
  .then(function(res) {
    console.log('Found character ID', res.data[0].id);
    return marvel.characters.comics(res.data[0].id);
  })
  .then(function(res) {
    console.log('found %s comics of %s total', res.meta.count, res.meta.total);
    console.log(res.data);
  })
  .fail(console.error)
  .done();

Si otterranno due formati di risposta ovvero data e meta. Nel primo caso avremo dei dati grezzi che l'API ci restituisce dopo essere stata interpellata, meta include invece le informazioni riguardo la ricerca, come ad esempio il numero di albi trovati e i rispettivi contenuti. Dunque per esempio:

{
  data: [
    {
      id: 43495,
      digitalId: 28150,
      ...
    },
    {
      id: 42566,
      digitalId: 0,
      ...
    }
  ],
  meta: {
    offset: 0,
    limit: 20,
    total: 2576,
    count: 20
  }
}

L'API viene suddivisa in varie parti in base ai dati che vengono elaborati. Ogni oggetto ha metodi per interagire con porzioni specifiche di dati per quell'oggetto, con alcune impostazioni predefinite. Sostanzialmente il pacchetto che si installa con npmè un wrapper realizzato con NodeJS, che interagisce direttamente con le Marvel Comics API.

Via Marvel