API – Application Programming Interface – Prima Parte

Restando nell’ambito di NodeJS utilizziamo il seguente codice per interrogare l’applicazione Express con i due endpoint pubblicati. Nella cartella del progetto aggiungiamo il file client.js e inseriamo il seguente codice.

const axios = require('axios');
 
// Esegui una richiesta GET all'endpoint API 
axios.get('http://localhost:3000/api/resource')
    .then((response) => {
      console.log('Risposta dal server API:');
      console.log(response.data);
    })
    .catch((error) => {
      console.error('Errore durante la richiesta al server API:', error);
});

Nella prima riga si importa il modulo axios e lo si attribuisce alla costante “axios“.
Nelle righe dalla quattro alla undici, si esegue una chiamata GET tramite protocollo HTTP all’endpoint statico del server Express API specificato precedentemente e attivo nel momento della chiamata. L’istruzione “catch” presente nella riga nove gestisce l’eventuale errore.

Ora, possiamo fare la prima prova di comunicazione tra il client e il server Express. Aprite un altra linea di comando digitando “CMD” selezionando il pulsante “START” di Windows (per ora non parliamo di tale operazione in ambiente GNU/Linux). Se non è presente il modulo axios, utilizzate il comando “npm install axios” da linea di comando.

Una volta raggiunta la cartella di progetto da linea di comando, digitate il seguente per avviare il client appena creato.

node client.js

Il risultato da linea di comando dovrebbe essere il seguente.

> node client.js
Risposta dal server API:
{ id: 1, name: 'Esempio di dato dal database' }

Come si vede, attraverso il client abbiamo interrogato l’endpoint statico e il risultato è stato quello corretto. Ma ora, modifichiamo la richiesta del client modificando la quarta riga come indicato di seguito.

4 axios.get('http://localhost:3000/api/resource/2')

A questo punto, eseguendo di nuovo l’istruzione “node client.js” dovremmo vedere il risultato seguente.

>node client.js
Risposta dal server API:
{ id: 2, name: 'Gatto' }

Ora, nella riga quattro del client la chiamata viene eseguita sul secondo endpoint, quello in cui si specifica il parametro id del database simulato “databasesim” presente nel codice del server app.js.

E’ il momento di passare all’esempio successivo, un po’ più complesso che potrebbe essere una richiesta da parte di una pubblica amministrazione e in particolare di un Comune interessato a gestire delle aree del suolo per eventi culturali, manifestazioni, e via dicendo.

Pagina Successiva | Pagina Precedente