TL;versione DR

In uno dei post precedenti abbiamo discusso, in breve, di com'è utilizzare l'API GitHub v3. Questa versione è progettata per essere interfacciata come qualsiasi altra API REST. Esistono endpoint per ogni risorsa a cui è necessario accedere e/o modificare. Ci sono endpoint per ogni utente, ogni organizzazione, ogni repository e così via. Ad esempio, ogni utente ha il suo endpoint API su https://api.github.it/utenti/ puoi provare a sostituire il tuo nome utente invece di e inserisci l'URL in un browser per vedere con cosa risponde l'API.

GitHub API v4, d'altra parte, utilizza GraphQL dove QL sta per Query Language. GraphQL è un nuovo modo di progettare le tue API. Così come ci sono molti servizi web offerti come API REST non solo quelli offerti da GitHub, ci sono molti servizi web che ti permettono di interfacciarti con loro tramite GraphQL.

La differenza più netta che noterai tra GraphQL e API REST è che GraphQL può funzionare con un singolo endpoint API. In caso di GitHub API v4, questo punto finale è https://api.github.com/graphql e basta. Non devi preoccuparti di aggiungere lunghe stringhe alla fine di un URI radice o fornire un parametro stringa di query per ulteriori informazioni. Invii semplicemente un argomento simile a JSON a questa API, chiedendo solo le cose di cui hai bisogno, e otterrai un payload JSON con le stesse esatte informazioni che hai richiesto. Non devi occuparti di filtrare le informazioni indesiderate o soffrire di sovraccarico delle prestazioni a causa di risposte di grandi dimensioni.

Che cos'è l'API REST??

Bene, REST sta per Representational State Transfer e API sta per Application Programming Interface. Un'API REST, o un'API "RESTful", è diventata la filosofia di progettazione fondamentale alla base della maggior parte delle moderne applicazioni client-server. L'idea nasce dalla necessità di separare i vari componenti di un'applicazione come l'interfaccia utente lato client e la logica lato server.

Quindi la sessione tra un client e un server è tipicamente senza stato. Una volta caricata la pagina Web e i relativi script, è possibile continuare a interagire con essi e quando si esegue un'azione (come premere un pulsante di invio) viene inviata una richiesta di invio insieme a tutte le informazioni contestuali necessarie al server Web per elaborare tale richiesta ( come nome utente, token, ecc.). L'applicazione passa da uno stato all'altro ma senza una costante necessità di connessione tra client e server.

REST definisce un insieme di vincoli tra il client e il server e la comunicazione può avvenire solo sotto tali vincoli. Ad esempio REST su HTTP di solito utilizza il modello CRUD, che sta per Crea, Leggi, Aggiorna ed Elimina e metodi HTTP come POST, GET, PUT e DELETE ti aiutano a eseguire quelle operazioni e quelle operazioni da soli. Le vecchie tecniche di intrusione come le iniezioni SQL non sono una possibilità con qualcosa come un'API REST ben scritta (anche se REST non è una panacea per la sicurezza).

Aiuta anche molto gli sviluppatori dell'interfaccia utente! Poiché tutto ciò che ricevi da una richiesta HTTP è un tipico flusso di testo (formattato come JSON, a volte) puoi facilmente implementare una pagina Web per browser o un'app (nella tua lingua preferita) senza preoccuparti dell'architettura lato server. Leggi la documentazione dell'API per servizi come Reddit, Twitter o Facebook e puoi scrivere estensioni per loro o per client di terze parti nella lingua che preferisci poiché hai la garanzia che il comportamento dell'API sarà sempre lo stesso.

Al contrario, al server non importa se il front-end è scritto in Go, Ruby o Python. Che si tratti di un browser, app o CLI. Semplicemente "vede" la richiesta e risponde in modo appropriato.

Cos'è GraphQL?

Come con qualsiasi cosa nel mondo dei computer, le API REST sono diventate più grandi e complesse e allo stesso tempo le persone volevano implementarle e utilizzarle in modo più rapido e semplice. Questo è il motivo per cui Facebook ha avuto l'idea di GraphQL e in seguito l'ha reso open source. Il QL in GraphQL sta per Query Language.

GraphQL consente ai clienti di effettuare richieste API molto specifiche, invece di effettuare chiamate API rigide con parametri e risposte predefinite. È molto più semplice perché il server risponde con esattamente i dati che gli hai chiesto, senza eccessi.

Dai un'occhiata a questa richiesta REST e alla sua risposta corrispondente. Questa richiesta ha lo scopo di visualizzare solo la biografia pubblica di un utente.