WEBVTT

1
00:00.800 --> 00:06.320
Il secondo passo nell'implementazione del
retrofit è la creazione dell'interfaccia
API.

2
00:06.320 --> 00:13.610
Qui dobbiamo creare una nuova interfaccia
Kotlin e un servizio API senza nome.

3
00:13.610 --> 00:21.110
Un'interfaccia di servizio API in Retrofit
è il punto in cui si definiscono gli
endpoint dei servizi web.

4
00:21.110 --> 00:25.520
Ogni metodo dell'interfaccia rappresenta
una chiamata API.

5
00:25.550 --> 00:32.180
Retrofit utilizza le annotazioni per
descrivere i metodi di richiesta HTTP e i
parametri.

6
00:32.180 --> 00:37.220
Quindi all'interno dell'interfaccia
dobbiamo creare la nostra prima richiesta.

7
00:37.220 --> 00:39.980
È di tipo funzione di sospensione.

8
00:39.980 --> 00:42.560
Ottenere film popolari.

9
00:42.560 --> 00:49.850
Come già detto, Retrofit utilizza le
annotazioni per descrivere i metodi di
richiesta HTTP e i parametri.

10
00:49.850 --> 00:53.990
A tal fine, è necessario annotare questo
metodo con un get.

11
00:54.020 --> 01:03.280
L'annotazione get specifica che questo
metodo eseguirà una

12
01:03.280 --> 01:04.000
richiesta Get Il valore sarà movie slash
popular.

13
01:04.000 --> 01:08.710
È il punto finale rispetto all'URL di
base.

14
01:08.740 --> 01:10.750
Torniamo al nostro URL.

15
01:10.750 --> 01:17.260
Questo è il nostro url api di base del
film db.org/3.

16
01:17.290 --> 01:21.580
La versione API è tre e il film popolare.

17
01:21.610 --> 01:23.140
Questo è il punto finale.

18
01:23.140 --> 01:32.470
Posso sostituirlo con le ultime uscite più
votate e altri

19
01:32.470 --> 01:34.060
endpoint, ma a noi interessa ottenere i
film più popolari.

20
01:34.060 --> 01:41.980
Quindi otteniamo l'URL di base, poi
l'endpoint e dobbiamo specificare la
chiave API.

21
01:42.010 --> 01:49.990
Dove passare la chiave API in questa
richiesta, passare la chiave API qui

22
01:50.020 --> 01:59.350
all'interno dei parametri del metodo get
popular movies nella query, specificando
la chiave

23
01:59.380 --> 02:03.820
API underscore key e assicurandosi di
scriverla Correct API underscore key API
key.

24
02:03.850 --> 02:05.620
È di tipo stringa.

25
02:05.650 --> 02:13.420
La query annota un parametro del metodo da
usare come parametro di query nell'URL.

26
02:13.450 --> 02:21.520
Qui sto passando la chiave API di tipo
stringa come parametro per il comando get
popular movies

27
02:21.520 --> 02:28.930
e l'annotazione query indica all'URL di
aggiungere la chiave API di tipo
underscore come parametro della query.

28
02:28.960 --> 02:35.800
La chiave API e si possono aggiungere
altri parametri come la pagina e altri
parametri.

29
02:35.800 --> 02:38.260
Più avanti parleremo della paginazione.

30
02:38.260 --> 02:43.240
I video successivi verranno aggiunti
all'URL come parametri di query.

31
02:43.240 --> 02:53.170
Quindi questo parametro, la chiave API,
sarà usato come parametro di query
aggiunto all'endpoint movie slash popular.

32
02:53.170 --> 02:57.490
Quindi, ancora una volta, abbiamo tre
sezioni nell'URL.

33
02:57.520 --> 03:02.400
L'endpoint dell'URL di base e il parametro
della query.

34
03:02.400 --> 03:03.660
È molto semplice.

35
03:03.660 --> 03:11.730
Abbiamo creato questa funzione come
funzione di sospensione che contrassegna
il metodo come

36
03:11.730 --> 03:15.000
funzione di sospensione da usare con le
coroutine Kotlin per l'esecuzione
asincrona.

37
03:15.000 --> 03:20.760
Quindi prenderemo i filmati più popolari,
eseguiremo questo metodo in background e
in modo asincrono.

38
03:20.760 --> 03:27.060
Nella nostra applicazione, dobbiamo
restituire un filmato in risposta a questo
metodo.

39
03:27.060 --> 03:35.340
Quindi, se torniamo alla risposta,
inseriamo l'URL, l'URL di base, l'endpoint
e la chiave API.

40
03:35.340 --> 03:38.640
E se facciamo clic su invio otterremo
questa risposta.

41
03:38.640 --> 03:46.290
Questa risposta è di tipo movie response,
la classe di dati che abbiamo

42
03:46.290 --> 03:51.390
creato prima che la risposta di questa
query restituisca un oggetto movie
response.

43
03:51.390 --> 03:56.790
Ecco come si crea l'interfaccia per la
libreria di retrofit