1 00:00:01,100 --> 00:00:04,510 ‫Narratore: Quindi, la nostra API ora è praticamente finita. 2 00:00:04,510 --> 00:00:07,003 ‫E così in questo 3 00:00:07,003 --> 00:00:09,680 ‫video finale della sezione, creeremo rapidamente 4 00:00:09,680 --> 00:00:13,020 ‫la documentazione per l'API direttamente in Postman. 5 00:00:13,020 --> 00:00:15,290 ‫Ed è vero, possiamo 6 00:00:15,290 --> 00:00:18,830 ‫facilmente creare una documentazione rapida direttamente in Postman. 7 00:00:18,830 --> 00:00:21,620 ‫Ed è davvero importante disporre della documentazione 8 00:00:21,620 --> 00:00:25,870 ‫API in atto perché è così che comunichiamo ai membri del 9 00:00:25,870 --> 00:00:29,140 ‫team, o anche ai nostri utenti finali dell'API, 10 00:00:29,140 --> 00:00:31,740 ‫come possono effettivamente utilizzarla nella pratica. 11 00:00:31,740 --> 00:00:33,973 ‫Quindi lascia che ora ti mostri come funziona. 12 00:00:35,490 --> 00:00:38,367 ‫Ora, prima di poter effettivamente creare la documentazione, 13 00:00:38,367 --> 00:00:40,920 ‫facciamo un po' di pulizia qui. 14 00:00:40,920 --> 00:00:45,010 ‫Ad esempio, liberati di questa richiesta, va bene? 15 00:00:47,550 --> 00:00:51,490 ‫Un'altra cosa che voglio fare è qui nel punto di 16 00:00:51,490 --> 00:00:55,180 ‫accesso, in realtà esponiamo la nostra password qui. 17 00:00:55,180 --> 00:00:58,220 ‫E quindi non è una buona idea, quindi quello 18 00:00:58,220 --> 00:01:00,350 ‫che farò è creare una variabile 19 00:01:00,350 --> 00:01:02,320 ‫d'ambiente che conterrà questa password. 20 00:01:02,320 --> 00:01:06,100 ‫Dal momento che è sempre lo stesso, non dovrebbero esserci problemi. 21 00:01:06,100 --> 00:01:07,833 ‫Quindi, ricorda come lo facciamo. 22 00:01:09,920 --> 00:01:12,730 ‫Bene, veniamo qui alla gestione dell'ambiente 23 00:01:13,970 --> 00:01:16,903 ‫e quindi qui ne aggiungiamo semplicemente un altro. 24 00:01:17,960 --> 00:01:19,807 ‫Quindi password, test1234. 25 00:01:23,820 --> 00:01:28,820 ‫E qui questo non è corretto, quindi password, aggiornata, e ora facciamo 26 00:01:30,220 --> 00:01:31,860 ‫lo stesso anche qui 27 00:01:31,860 --> 00:01:33,363 ‫in produzione. 28 00:01:35,440 --> 00:01:37,297 ‫Quindi password, test1234. 29 00:01:41,020 --> 00:01:46,020 ‫E quindi, non aggiungere, ma chiudiamolo e quindi qui 30 00:01:46,590 --> 00:01:51,120 ‫ora posso aggiungere e usarlo, non in 31 00:01:51,120 --> 00:01:55,003 ‫una stringa, ma in questo modo. 32 00:01:56,840 --> 00:01:58,490 ‫Quindi password. 33 00:01:58,490 --> 00:01:59,633 ‫Quindi proviamolo. 34 00:02:00,980 --> 00:02:04,620 ‫E questo ci dà questo strano errore, ma la 35 00:02:04,620 --> 00:02:07,840 ‫nostra password è in realtà qui, quindi 36 00:02:07,840 --> 00:02:12,313 ‫probabilmente quello che dobbiamo fare è mettere davvero le virgolette qui. 37 00:02:13,360 --> 00:02:14,680 ‫Quindi proviamolo. 38 00:02:14,680 --> 00:02:17,740 ‫E così ora, in effetti, abbiamo effettuato l'accesso con successo. 39 00:02:17,740 --> 00:02:21,090 ‫Quindi salvalo ora, ok? 40 00:02:21,090 --> 00:02:23,990 ‫E quindi ora quello che dovremmo fare è creare 41 00:02:23,990 --> 00:02:26,290 ‫effettivamente una descrizione per ogni singola richiesta 42 00:02:26,290 --> 00:02:28,150 ‫che abbiamo nella nostra collezione. 43 00:02:28,150 --> 00:02:30,120 ‫Ora, ovviamente, non lo 44 00:02:30,120 --> 00:02:33,173 ‫farò, lo esemplificherò qui con il primo. 45 00:02:34,270 --> 00:02:35,103 ‫Va bene? 46 00:02:36,630 --> 00:02:39,250 ‫Quindi chiudiamo effettivamente questi altri 47 00:02:39,250 --> 00:02:42,840 ‫e quindi ora qui possiamo aggiungere una descrizione. 48 00:02:42,840 --> 00:02:46,350 ‫E quindi diciamo solo, usa questo endpoint 49 00:02:49,150 --> 00:02:52,403 ‫per creare un nuovo tour. 50 00:02:53,530 --> 00:02:58,514 ‫Ok, e di nuovo, ora dovresti fare esattamente la stessa cosa per 51 00:02:58,514 --> 00:03:03,030 ‫tutte le tue richieste se il tuo obiettivo è davvero pubblicare 52 00:03:03,030 --> 00:03:06,170 ‫e condividere la tua API, ok? 53 00:03:06,170 --> 00:03:09,633 ‫Quindi la stessa cosa vale per le cartelle 54 00:03:11,130 --> 00:03:14,300 ‫e non per rinominare, ma per modificare. 55 00:03:14,300 --> 00:03:15,900 ‫E così in ognuna 56 00:03:15,900 --> 00:03:18,870 ‫di queste cartelle possiamo effettivamente aggiungere anche una descrizione. 57 00:03:18,870 --> 00:03:23,380 ‫Quindi diciamo solo qualcosa di casuale come, puoi 58 00:03:23,380 --> 00:03:27,093 ‫ottenere tutti i tour, crearne di 59 00:03:27,960 --> 00:03:29,463 ‫nuovi e 60 00:03:31,400 --> 00:03:34,743 ‫modificare ed eliminare i tour. 61 00:03:36,580 --> 00:03:41,000 ‫Esistono anche endpoint speciali per alcuni 62 00:03:42,630 --> 00:03:44,763 ‫requisiti speciali. 63 00:03:46,170 --> 00:03:48,680 ‫Ok, e di nuovo questo è 64 00:03:48,680 --> 00:03:52,350 ‫totalmente casuale e pubblicherei qualcosa di simile per la 65 00:03:52,350 --> 00:03:56,100 ‫mia API, ma qui vogliamo solo testare come funziona, ok? 66 00:03:56,100 --> 00:03:57,540 ‫Come puoi vedere 67 00:03:57,540 --> 00:04:00,800 ‫qui sotto, puoi anche usare Mark qui sotto, ok? 68 00:04:00,800 --> 00:04:03,240 ‫Quindi, per esempio, per rendere il 69 00:04:03,240 --> 00:04:06,273 ‫testo in grassetto, puoi pensare che funzioni così, sì, 70 00:04:07,820 --> 00:04:09,920 ‫sembra che funzioni, e quindi 71 00:04:09,920 --> 00:04:13,523 ‫sì, puoi fare tutti i tipi di cose qui, ok? 72 00:04:15,970 --> 00:04:18,730 ‫Probabilmente puoi anche 73 00:04:18,730 --> 00:04:21,500 ‫creare una descrizione su 74 00:04:21,500 --> 00:04:26,363 ‫Natours stesso, quindi diciamo che l'API Natours 75 00:04:30,950 --> 00:04:35,950 ‫contiene endpoint per tour, utenti e recensioni. 76 00:04:37,790 --> 00:04:39,510 ‫E poi ancora un 77 00:04:39,510 --> 00:04:42,500 ‫sacco di cose, come potresti descrivere il tuo processo 78 00:04:42,500 --> 00:04:45,320 ‫di autenticazione, o le tue autorizzazioni e davvero 79 00:04:45,320 --> 00:04:48,820 ‫tutto ciò che l'utente deve sapere per utilizzare questa API, ok? 80 00:04:48,820 --> 00:04:50,510 ‫Quindi dovresti sempre 81 00:04:50,510 --> 00:04:54,060 ‫aggiungere una descrizione a tutte le richieste, a tutte 82 00:04:54,060 --> 00:04:57,490 ‫le cartelle e anche, ovviamente, alla collezione stessa. 83 00:04:57,490 --> 00:05:01,510 ‫Oh, e possiamo effettivamente descrivere i parametri di query in una 84 00:05:01,510 --> 00:05:03,943 ‫stringa di query, quindi facciamolo qui. 85 00:05:09,634 --> 00:05:13,384 ‫E possiamo anche dire che supporta gli 86 00:05:14,620 --> 00:05:19,620 ‫operatori maggiore di, minore di uguale, maggiore di e minore di. 87 00:05:23,070 --> 00:05:24,890 ‫Quindi di nuovo, solo un 88 00:05:26,070 --> 00:05:28,490 ‫esempio qui e salviamolo ora nella richiesta. 89 00:05:28,490 --> 00:05:30,580 ‫E quindi con questo penso che 90 00:05:30,580 --> 00:05:33,700 ‫dovremmo essere pronti a pubblicare effettivamente la nostra documentazione API. 91 00:05:33,700 --> 00:05:36,750 ‫E quindi per farlo, andiamo 92 00:05:36,750 --> 00:05:39,910 ‫qui all'opzione collection, e poi quaggiù, 93 00:05:39,910 --> 00:05:42,070 ‫pubblichiamo la documentazione. 94 00:05:42,070 --> 00:05:45,400 ‫E quindi dovrebbe aprire una finestra del browser, e per 95 00:05:45,400 --> 00:05:47,830 ‫me lo ha fatto al di fuori 96 00:05:47,830 --> 00:05:50,570 ‫del mio schermo, quindi fammi solo arrivare qui. 97 00:05:50,570 --> 00:05:53,700 ‫E così ora puoi scegliere l'ambiente. 98 00:05:53,700 --> 00:05:57,200 ‫Quindi qui dovremmo avere un elenco dei nostri ambienti, 99 00:05:57,200 --> 00:06:01,470 ‫che per qualche ragione non abbiamo, è strano, ma comunque, non volevamo 100 00:06:01,470 --> 00:06:05,060 ‫usare nessun ambiente comunque, perché ciò avrebbe quindi sostituito le 101 00:06:05,060 --> 00:06:06,540 ‫nostre variabili di ambiente 102 00:06:06,540 --> 00:06:09,340 ‫con i loro valori reali, e non 103 00:06:09,340 --> 00:06:10,460 ‫lo vogliamo. 104 00:06:10,460 --> 00:06:12,620 ‫Ad esempio, abbiamo usato la variabile 105 00:06:12,620 --> 00:06:14,620 ‫d'ambiente sulla password, in modo 106 00:06:14,620 --> 00:06:17,900 ‫che poi nella documentazione non sia realmente visibile, ok? 107 00:06:17,900 --> 00:06:20,313 ‫Quindi non vogliamo davvero usare alcun ambiente. 108 00:06:21,270 --> 00:06:23,280 ‫Ora potremmo anche usare un 109 00:06:23,280 --> 00:06:27,610 ‫dominio personalizzato, ma è solo per gli utenti a pagamento, ok? 110 00:06:27,610 --> 00:06:30,740 ‫Quindi potremmo anche cambiare tutto lo stile dell'API 111 00:06:30,740 --> 00:06:34,410 ‫in modo che corrisponda ai colori del tuo marchio, 112 00:06:34,410 --> 00:06:37,260 ‫ma di nuovo, non è necessario 113 00:06:37,260 --> 00:06:40,620 ‫in questo caso, quindi andiamo avanti e pubblichiamolo. 114 00:06:40,620 --> 00:06:42,550 ‫E così ora, questo è in 115 00:06:42,550 --> 00:06:46,367 ‫realtà pubblico, quindi tutti possono visualizzare la tua documentazione ora su questo URL. 116 00:06:47,480 --> 00:06:51,300 ‫Ora, per qualche ragione, non ha aggiornato tutti i cambiamenti che 117 00:06:51,300 --> 00:06:54,653 ‫abbiamo appena fatto prima, quindi è un po' strano. 118 00:06:55,510 --> 00:06:58,420 ‫Quindi torniamo da Postman e vediamo 119 00:06:58,420 --> 00:07:00,090 ‫cosa sta succedendo. 120 00:07:00,090 --> 00:07:04,510 ‫Forse ha a che fare con questa cosa che ruota qui, 121 00:07:04,510 --> 00:07:07,158 ‫quindi lascerò Postman e lo riaprirò. 122 00:07:07,158 --> 00:07:09,393 ‫E speriamo che lo risolva. 123 00:07:12,610 --> 00:07:15,060 ‫Quindi se ora ricarichiamo qui, 124 00:07:15,060 --> 00:07:18,720 ‫ahh allora otteniamo tutte le nostre modifiche effettivamente qui. 125 00:07:18,720 --> 00:07:20,980 ‫Quindi vedete, la descrizione che 126 00:07:20,980 --> 00:07:23,620 ‫abbiamo aggiunto per la collezione Natours, ok? 127 00:07:23,620 --> 00:07:26,830 ‫Quindi anche la descrizione per questa cartella e 128 00:07:26,830 --> 00:07:29,530 ‫la descrizione per questa richiesta. 129 00:07:29,530 --> 00:07:32,180 ‫E infine, come prima 130 00:07:32,180 --> 00:07:35,400 ‫descrizione, anche per questo parametro, ok? 131 00:07:35,400 --> 00:07:39,477 ‫Qui otteniamo quindi la variabile di ambiente 132 00:07:39,477 --> 00:07:41,850 ‫URL invece dell'URL effettivo. 133 00:07:41,850 --> 00:07:44,310 ‫Ora, naturalmente, potresti voler effettivamente fornire l'URL 134 00:07:44,310 --> 00:07:46,320 ‫reale qui e per questo 135 00:07:46,320 --> 00:07:48,443 ‫potresti semplicemente usare un altro ambiente. 136 00:07:50,150 --> 00:07:53,170 ‫Quindi qui sopra puoi effettivamente vedere tutti gli 137 00:07:53,170 --> 00:07:57,060 ‫ambienti ma sono privati, quindi in questo momento nessuno può usarli, 138 00:07:57,060 --> 00:07:58,720 ‫ma ricorda come 139 00:07:58,720 --> 00:08:01,430 ‫nel primo passaggio, avremmo potuto effettivamente creare 140 00:08:01,430 --> 00:08:04,760 ‫questa documentazione usando uno degli ambienti, e quindi probabilmente 141 00:08:04,760 --> 00:08:07,990 ‫lo faremmo abbiamo utilizzato l'ambiente di produzione per 142 00:08:07,990 --> 00:08:11,350 ‫quello e quindi con quello avremmo l'URL di produzione 143 00:08:11,350 --> 00:08:14,543 ‫finale qui negli URL delle nostre API, ok? 144 00:08:15,440 --> 00:08:18,064 ‫Ad ogni modo, ecco come 145 00:08:18,064 --> 00:08:21,530 ‫appare la documentazione, quindi ecco la richiesta di 146 00:08:21,530 --> 00:08:24,940 ‫esempio e possiamo cambiarla anche nella nostra lingua. 147 00:08:24,940 --> 00:08:27,840 ‫Quindi, in questo caso, Node 148 00:08:27,840 --> 00:08:31,020 ‫JS, ma se l'utente, ad esempio, esegue 149 00:08:31,020 --> 00:08:34,770 ‫una richiesta utilizzando jQuery, può semplicemente utilizzare jQuery, ok. 150 00:08:34,770 --> 00:08:39,290 ‫Quindi, solo per vedere questa richiesta di esempio qui, quindi con Node, sembra 151 00:08:39,290 --> 00:08:40,793 ‫qualcosa del genere. 152 00:08:42,870 --> 00:08:45,213 ‫Quindi, qui abbiamo tutti i nostri 153 00:08:45,213 --> 00:08:48,400 ‫endpoint e puoi vedere che quelli che richiedono l'autenticazione, 154 00:08:48,400 --> 00:08:51,400 ‫in realtà hanno questa icona di blocco qui. 155 00:08:51,400 --> 00:08:54,299 ‫E quindi nella tua descrizione ora puoi 156 00:08:54,299 --> 00:08:57,960 ‫aggiungere che dicendo che devi accedere, per accedere a questo 157 00:08:57,960 --> 00:09:01,060 ‫endpoint, e anche come puoi effettivamente accedere, ok. 158 00:09:01,060 --> 00:09:02,760 ‫Oppure puoi anche 159 00:09:02,760 --> 00:09:06,290 ‫descriverlo qui nella sezione di autenticazione, giusto? 160 00:09:06,290 --> 00:09:09,243 ‫Quindi, idealmente, avresti descrizioni per tutto questo. 161 00:09:10,360 --> 00:09:11,948 ‫Oh, e qui vedo 162 00:09:11,948 --> 00:09:15,770 ‫che in realtà ci siamo dimenticati di sostituire la vera 163 00:09:15,770 --> 00:09:19,940 ‫password, ma non importa perché questo è davvero solo un esempio, ok? 164 00:09:19,940 --> 00:09:22,040 ‫Ma ovviamente, ricevi tutte le 165 00:09:22,040 --> 00:09:24,933 ‫richieste che abbiamo avuto nel nostro postino anche qui. 166 00:09:26,900 --> 00:09:30,780 ‫Ora un'altra bella caratteristica qui è questo pulsante Esegui in Postman, e 167 00:09:30,780 --> 00:09:33,830 ‫quindi se qualcuno ha Postman installato sul proprio computer, 168 00:09:33,830 --> 00:09:36,380 ‫tutto ciò che deve fare è 169 00:09:36,380 --> 00:09:40,000 ‫fare clic qui e quindi aprire con la propria applicazione Postman. 170 00:09:40,000 --> 00:09:42,490 ‫Ora non lo farò in questo momento perché, 171 00:09:42,490 --> 00:09:45,830 ‫naturalmente, ce l'ho già nel mio postino, ma per il resto 172 00:09:45,830 --> 00:09:49,270 ‫questa è una funzionalità davvero interessante per gli utenti che possono andare 173 00:09:49,270 --> 00:09:52,253 ‫avanti e iniziare subito a sperimentare con la tua API. 174 00:09:54,070 --> 00:09:57,370 ‫Ok, e penso che sia davvero così, quindi questo 175 00:09:57,370 --> 00:09:59,330 ‫conclude la nostra sezione 176 00:09:59,330 --> 00:10:02,610 ‫e la nostra API è ora finalmente davvero completata. 177 00:10:02,610 --> 00:10:06,440 ‫Quindi ancora una volta, congratulazioni per essere arrivati fino a 178 00:10:06,440 --> 00:10:08,720 ‫questo punto nel corso, abbiamo 179 00:10:08,720 --> 00:10:11,140 ‫già coperto così tanto terreno qui insieme. 180 00:10:11,140 --> 00:10:14,230 ‫Ora il prossimo, c'è una sezione molto, molto eccitante 181 00:10:14,230 --> 00:10:16,460 ‫in avanti dove costruiremo finalmente il 182 00:10:16,460 --> 00:10:19,260 ‫volto dell'utente per il sito web di Natours. 183 00:10:19,260 --> 00:10:21,510 ‫Quindi, in pratica, utilizzeremo i 184 00:10:21,510 --> 00:10:24,770 ‫modelli per creare un sito Web completamente dinamico basato su 185 00:10:24,770 --> 00:10:27,810 ‫tutti i dati che abbiamo già nel nostro database. 186 00:10:27,810 --> 00:10:29,380 ‫Ed è davvero fantastico. 187 00:10:29,380 --> 00:10:32,053 ‫E quindi non vedo l'ora di mostrartelo.