Il secondo passo nell'implementazione del retrofit è la creazione dell'interfaccia API.
Qui dobbiamo creare una nuova interfaccia Kotlin e un servizio API senza nome.
Un'interfaccia di servizio API in Retrofit è il punto in cui si definiscono gli endpoint dei servizi web.
Ogni metodo dell'interfaccia rappresenta una chiamata API.
Retrofit utilizza le annotazioni per descrivere i metodi di richiesta HTTP e i parametri.
Quindi all'interno dell'interfaccia dobbiamo creare la nostra prima richiesta.
È di tipo funzione di sospensione.
Ottenere film popolari.
Come già detto, Retrofit utilizza le annotazioni per descrivere i metodi di richiesta HTTP e i parametri.
A tal fine, è necessario annotare questo metodo con un get.
L'annotazione get specifica che questo metodo eseguirà una
richiesta Get Il valore sarà movie slash popular.
È il punto finale rispetto all'URL di base.
Torniamo al nostro URL.
Questo è il nostro url api di base del film db.org/3.
La versione API è tre e il film popolare.
Questo è il punto finale.
Posso sostituirlo con le ultime uscite più votate e altri
endpoint, ma a noi interessa ottenere i film più popolari.
Quindi otteniamo l'URL di base, poi l'endpoint e dobbiamo specificare la chiave API.
Dove passare la chiave API in questa richiesta, passare la chiave API qui
all'interno dei parametri del metodo get popular movies nella query, specificando la chiave
API underscore key e assicurandosi di scriverla Correct API underscore key API key.
È di tipo stringa.
La query annota un parametro del metodo da usare come parametro di query nell'URL.
Qui sto passando la chiave API di tipo stringa come parametro per il comando get popular movies
e l'annotazione query indica all'URL di aggiungere la chiave API di tipo underscore come parametro della query.
La chiave API e si possono aggiungere altri parametri come la pagina e altri parametri.
Più avanti parleremo della paginazione.
I video successivi verranno aggiunti all'URL come parametri di query.
Quindi questo parametro, la chiave API, sarà usato come parametro di query aggiunto all'endpoint movie slash popular.
Quindi, ancora una volta, abbiamo tre sezioni nell'URL.
L'endpoint dell'URL di base e il parametro della query.
È molto semplice.
Abbiamo creato questa funzione come funzione di sospensione che contrassegna il metodo come
funzione di sospensione da usare con le coroutine Kotlin per l'esecuzione asincrona.
Quindi prenderemo i filmati più popolari, eseguiremo questo metodo in background e in modo asincrono.
Nella nostra applicazione, dobbiamo restituire un filmato in risposta a questo metodo.
Quindi, se torniamo alla risposta, inseriamo l'URL, l'URL di base, l'endpoint e la chiave API.
E se facciamo clic su invio otterremo questa risposta.
Questa risposta è di tipo movie response, la classe di dati che abbiamo
creato prima che la risposta di questa query restituisca un oggetto movie response.
Ecco come si crea l'interfaccia per la libreria di retrofit