1
00:00:01,100 --> 00:00:04,510
‫Narrador: Entonces, nuestra API ahora está básicamente terminada.

2
00:00:04,510 --> 00:00:07,003
‫Entonces, en este video

3
00:00:07,003 --> 00:00:09,680
‫final de la sección, crearemos

4
00:00:09,680 --> 00:00:13,020
‫rápidamente documentación para API directamente en Postman.

5
00:00:13,020 --> 00:00:15,290
‫Y así es, podemos

6
00:00:15,290 --> 00:00:18,830
‫crear fácilmente documentación rápida directamente en Postman.

7
00:00:18,830 --> 00:00:21,620
‫Y es realmente importante contar con la documentación

8
00:00:21,620 --> 00:00:25,870
‫de la API porque así es como nos comunicamos con los miembros del

9
00:00:25,870 --> 00:00:29,140
‫equipo, o incluso con nuestros usuarios finales de la API,

10
00:00:29,140 --> 00:00:31,740
‫cómo pueden usarla en la práctica.

11
00:00:31,740 --> 00:00:33,973
‫Déjame mostrarte cómo funciona.

12
00:00:35,490 --> 00:00:38,367
‫Ahora, antes de que podamos crear la

13
00:00:38,367 --> 00:00:40,920
‫documentación, hagamos una limpieza aquí.

14
00:00:40,920 --> 00:00:45,010
‫Por ejemplo, deshazte de esta solicitud, ¿de acuerdo?

15
00:00:47,550 --> 00:00:51,490
‫Otra cosa que quiero hacer es aquí en el punto de

16
00:00:51,490 --> 00:00:55,180
‫inicio de sesión, de hecho exponemos nuestra contraseña aquí.

17
00:00:55,180 --> 00:00:58,220
‫Y esa no es una buena idea, así que lo que voy

18
00:00:58,220 --> 00:01:00,350
‫a hacer es crear una variable de entorno

19
00:01:00,350 --> 00:01:02,320
‫que va a contener esta contraseña.

20
00:01:02,320 --> 00:01:06,100
‫Dado que siempre es lo mismo, eso no debería ser un problema.

21
00:01:06,100 --> 00:01:07,833
‫Entonces, recuerde cómo lo hacemos.

22
00:01:09,920 --> 00:01:12,730
‫Bueno, venimos aquí a administrar el

23
00:01:13,970 --> 00:01:16,903
‫medio ambiente y aquí simplemente agregamos otro.

24
00:01:17,960 --> 00:01:19,807
‫Entonces contraseña, test1234.

25
00:01:23,820 --> 00:01:28,820
‫Y aquí esto no es correcto, así que contraseña, actualizada, y ahora, hagamos

26
00:01:30,220 --> 00:01:31,860
‫lo mismo aquí en

27
00:01:31,860 --> 00:01:33,363
‫la producción también.

28
00:01:35,440 --> 00:01:37,297
‫Entonces contraseña, test1234.

29
00:01:41,020 --> 00:01:46,020
‫Y entonces, no agregar, pero cerremos eso y

30
00:01:46,590 --> 00:01:51,120
‫aquí ahora puedo agregar y usar eso,

31
00:01:51,120 --> 00:01:55,003
‫no en una cadena, sino así.

32
00:01:56,840 --> 00:01:58,490
‫Entonces contraseña.

33
00:01:58,490 --> 00:01:59,633
‫Así que intentemos eso.

34
00:02:00,980 --> 00:02:04,620
‫Y esto nos da este extraño error, pero

35
00:02:04,620 --> 00:02:07,840
‫nuestra contraseña está realmente aquí, así que

36
00:02:07,840 --> 00:02:12,313
‫probablemente lo que tenemos que hacer es poner las comillas aquí.

37
00:02:13,360 --> 00:02:14,680
‫Así que intentemos eso.

38
00:02:14,680 --> 00:02:17,740
‫Y ahora, de hecho, hemos iniciado sesión con éxito.

39
00:02:17,740 --> 00:02:21,090
‫Así que guárdalo ahora, ¿de acuerdo?

40
00:02:21,090 --> 00:02:23,990
‫Y ahora lo que debemos hacer es crear una descripción

41
00:02:23,990 --> 00:02:26,290
‫para todas y cada una de las solicitudes

42
00:02:26,290 --> 00:02:28,150
‫que tenemos en nuestra colección.

43
00:02:28,150 --> 00:02:30,120
‫Ahora, por supuesto, no voy

44
00:02:30,120 --> 00:02:33,173
‫a hacer eso, solo lo ejemplificaré aquí con el primero.

45
00:02:34,270 --> 00:02:35,103
‫¿Okey?

46
00:02:36,630 --> 00:02:39,250
‫Así que vamos a cerrar

47
00:02:39,250 --> 00:02:42,840
‫estos otros y ahora aquí podemos agregar una descripción.

48
00:02:42,840 --> 00:02:46,350
‫Entonces, digamos, use este punto final

49
00:02:49,150 --> 00:02:52,403
‫para crear un nuevo recorrido.

50
00:02:53,530 --> 00:02:58,514
‫De acuerdo, y nuevamente, ahora debería hacer exactamente lo mismo para

51
00:02:58,514 --> 00:03:03,030
‫todas sus solicitudes si su objetivo es realmente publicar

52
00:03:03,030 --> 00:03:06,170
‫y compartir su API, ¿de acuerdo?

53
00:03:06,170 --> 00:03:09,633
‫Entonces lo mismo se aplica a las carpetas, y

54
00:03:11,130 --> 00:03:14,300
‫no a cambiar el nombre, sino a editar.

55
00:03:14,300 --> 00:03:15,900
‫Y así, en cada

56
00:03:15,900 --> 00:03:18,870
‫una de estas carpetas, también podemos agregar una descripción.

57
00:03:18,870 --> 00:03:23,380
‫Entonces, digamos algo aleatorio como, puede

58
00:03:23,380 --> 00:03:27,093
‫obtener todos los recorridos, crear

59
00:03:27,960 --> 00:03:29,463
‫nuevos

60
00:03:31,400 --> 00:03:34,743
‫y editar y eliminar recorridos.

61
00:03:36,580 --> 00:03:41,000
‫También hay puntos finales especiales para algunos

62
00:03:42,630 --> 00:03:44,763
‫requisitos especiales.

63
00:03:46,170 --> 00:03:48,680
‫De acuerdo, una y otra vez, esto

64
00:03:48,680 --> 00:03:52,350
‫es totalmente aleatorio y publicaría algo como esto para mi propia

65
00:03:52,350 --> 00:03:56,100
‫API, pero aquí realmente solo queremos probar cómo funciona, ¿de acuerdo?

66
00:03:56,100 --> 00:03:57,540
‫Como puede ver

67
00:03:57,540 --> 00:04:00,800
‫aquí abajo, también puede usar Mark aquí, ¿de acuerdo?

68
00:04:00,800 --> 00:04:03,240
‫Entonces, por ejemplo, para poner el

69
00:04:03,240 --> 00:04:06,273
‫texto en negrita, puedes pensar que funciona así, sí,

70
00:04:07,820 --> 00:04:09,920
‫parece que lo hace, y

71
00:04:09,920 --> 00:04:13,523
‫sí, puedes hacer todo tipo de cosas aquí, ¿de acuerdo?

72
00:04:15,970 --> 00:04:18,730
‫Probablemente también puedas

73
00:04:18,730 --> 00:04:21,500
‫crear una descripción en Natours,

74
00:04:21,500 --> 00:04:26,363
‫así que digamos que la API de Natours

75
00:04:30,950 --> 00:04:35,950
‫contiene puntos finales para recorridos, usuarios y reseñas.

76
00:04:37,790 --> 00:04:39,510
‫Y luego, nuevamente, un

77
00:04:39,510 --> 00:04:42,500
‫montón de cosas, como si pudiera describir su proceso

78
00:04:42,500 --> 00:04:45,320
‫de autenticación, o sus permisos y realmente todo lo

79
00:04:45,320 --> 00:04:48,820
‫que el usuario necesita saber para usar esta API, ¿de acuerdo?

80
00:04:48,820 --> 00:04:50,510
‫Por lo tanto, siempre

81
00:04:50,510 --> 00:04:54,060
‫debe agregar una descripción a todas las solicitudes, a todas las

82
00:04:54,060 --> 00:04:57,490
‫carpetas y también, por supuesto, a la colección en sí.

83
00:04:57,490 --> 00:05:01,510
‫Ah, y de hecho podemos describir los parámetros de consulta en una

84
00:05:01,510 --> 00:05:03,943
‫cadena de consulta, así que hagámoslo aquí.

85
00:05:09,634 --> 00:05:13,384
‫Y también podemos decir que admite operadores

86
00:05:14,620 --> 00:05:19,620
‫mayor que, menor que igual, mayor que y menor que.

87
00:05:23,070 --> 00:05:24,890
‫Entonces, nuevamente, solo un ejemplo

88
00:05:26,070 --> 00:05:28,490
‫aquí y guardémoslo ahora en la solicitud.

89
00:05:28,490 --> 00:05:30,580
‫Y con esto, creo que deberíamos

90
00:05:30,580 --> 00:05:33,700
‫estar listos para publicar la documentación de nuestra API.

91
00:05:33,700 --> 00:05:36,750
‫Y para hacer eso, vayamos aquí a

92
00:05:36,750 --> 00:05:39,910
‫la opción de colecciones, y luego aquí

93
00:05:39,910 --> 00:05:42,070
‫abajo, publiquemos la documentación.

94
00:05:42,070 --> 00:05:45,400
‫Entonces eso debería abrir una ventana del navegador, y

95
00:05:45,400 --> 00:05:47,830
‫para mí lo hizo fuera de

96
00:05:47,830 --> 00:05:50,570
‫mi pantalla, así que déjame verlo aquí.

97
00:05:50,570 --> 00:05:53,700
‫Y ahora puedes elegir el entorno.

98
00:05:53,700 --> 00:05:57,200
‫Entonces, aquí deberíamos tener una lista de nuestros entornos, que

99
00:05:57,200 --> 00:06:01,470
‫por alguna razón no tenemos, eso es extraño, pero de todos modos,

100
00:06:01,470 --> 00:06:05,060
‫no queríamos usar ningún entorno de todos modos, porque eso

101
00:06:05,060 --> 00:06:06,540
‫reemplazaría nuestras variables de

102
00:06:06,540 --> 00:06:09,340
‫entorno con sus valores reales, y no

103
00:06:09,340 --> 00:06:10,460
‫queremos eso.

104
00:06:10,460 --> 00:06:12,620
‫Por ejemplo, usamos la variable de entorno

105
00:06:12,620 --> 00:06:14,620
‫en la contraseña, para que

106
00:06:14,620 --> 00:06:17,900
‫luego en la documentación no sea realmente visible, ¿de acuerdo?

107
00:06:17,900 --> 00:06:20,313
‫Por tanto, no queremos utilizar ningún entorno.

108
00:06:21,270 --> 00:06:23,280
‫Ahora también podríamos usar un

109
00:06:23,280 --> 00:06:27,610
‫dominio personalizado, pero eso es solo para usuarios pagos, ¿de acuerdo?

110
00:06:27,610 --> 00:06:30,740
‫Luego, también podríamos cambiar todo el estilo de la

111
00:06:30,740 --> 00:06:34,410
‫API para que coincida con los colores de su marca,

112
00:06:34,410 --> 00:06:37,260
‫pero nuevamente, eso no es necesario en

113
00:06:37,260 --> 00:06:40,620
‫este caso, por lo tanto, sigamos adelante y publíquelo.

114
00:06:40,620 --> 00:06:42,550
‫Y ahora, esto es realmente público,

115
00:06:42,550 --> 00:06:46,367
‫por lo que todos pueden ver su documentación ahora en esta URL.

116
00:06:47,480 --> 00:06:51,300
‫Ahora, por alguna razón, realmente no actualizó todos los cambios que

117
00:06:51,300 --> 00:06:54,653
‫hicimos antes, así que eso es un poco extraño.

118
00:06:55,510 --> 00:06:58,420
‫Así que volvamos a Postman y veamos

119
00:06:58,420 --> 00:07:00,090
‫qué está pasando.

120
00:07:00,090 --> 00:07:04,510
‫Tal vez tenga que ver con esta cosa giratoria aquí, así que simplemente

121
00:07:04,510 --> 00:07:07,158
‫saldré de Postman y lo abriré nuevamente.

122
00:07:07,158 --> 00:07:09,393
‫Y esperemos que eso lo solucione.

123
00:07:12,610 --> 00:07:15,060
‫Entonces, si ahora recargamos

124
00:07:15,060 --> 00:07:18,720
‫aquí, entonces obtendremos todos nuestros cambios aquí.

125
00:07:18,720 --> 00:07:20,980
‫Ya ves, la descripción que

126
00:07:20,980 --> 00:07:23,620
‫agregamos para la colección Natours, ¿de acuerdo?

127
00:07:23,620 --> 00:07:26,830
‫Luego, también la descripción de esta carpeta y

128
00:07:26,830 --> 00:07:29,530
‫la descripción de esta solicitud.

129
00:07:29,530 --> 00:07:32,180
‫Y finalmente, como la primera

130
00:07:32,180 --> 00:07:35,400
‫descripción, también para este parámetro, ¿de acuerdo?

131
00:07:35,400 --> 00:07:39,477
‫Aquí obtenemos la variable de entorno URL en lugar

132
00:07:39,477 --> 00:07:41,850
‫de la URL real.

133
00:07:41,850 --> 00:07:44,310
‫Ahora, por supuesto, es posible que desee dar

134
00:07:44,310 --> 00:07:46,320
‫la URL real aquí y,

135
00:07:46,320 --> 00:07:48,443
‫para eso, simplemente podría usar otro entorno.

136
00:07:50,150 --> 00:07:53,170
‫Así que aquí puede ver todos los entornos,

137
00:07:53,170 --> 00:07:57,060
‫pero son privados, por lo que en este momento nadie puede

138
00:07:57,060 --> 00:07:58,720
‫usarlos, pero recuerde que

139
00:07:58,720 --> 00:08:01,430
‫en el primer paso, podríamos haber creado

140
00:08:01,430 --> 00:08:04,760
‫esta documentación utilizando uno de los entornos, y probablemente

141
00:08:04,760 --> 00:08:07,990
‫lo haríamos. hemos utilizado el entorno de producción para

142
00:08:07,990 --> 00:08:11,350
‫eso y, por lo tanto, tendríamos la URL de producción

143
00:08:11,350 --> 00:08:14,543
‫final aquí en nuestras URL de API, ¿de acuerdo?

144
00:08:15,440 --> 00:08:18,064
‫De todos modos, así es como

145
00:08:18,064 --> 00:08:21,530
‫se ve la documentación, así que aquí está la solicitud

146
00:08:21,530 --> 00:08:24,940
‫de ejemplo y podemos cambiarla también a nuestro propio idioma.

147
00:08:24,940 --> 00:08:27,840
‫Entonces, en este caso, Node JS,

148
00:08:27,840 --> 00:08:31,020
‫pero si el usuario, por ejemplo, está haciendo

149
00:08:31,020 --> 00:08:34,770
‫una solicitud usando jQuery, entonces puede usar jQuery, está bien.

150
00:08:34,770 --> 00:08:39,290
‫Entonces, solo para ver esta solicitud de ejemplo aquí, con Node, se ve

151
00:08:39,290 --> 00:08:40,793
‫algo como esto.

152
00:08:42,870 --> 00:08:45,213
‫Entonces, aquí tenemos todos nuestros puntos

153
00:08:45,213 --> 00:08:48,400
‫finales y puede ver que los que requieren autenticación,

154
00:08:48,400 --> 00:08:51,400
‫en realidad tienen este ícono de candado aquí.

155
00:08:51,400 --> 00:08:54,299
‫Entonces, en su descripción, ahora podría agregar

156
00:08:54,299 --> 00:08:57,960
‫que dice que necesita iniciar sesión para acceder a este punto

157
00:08:57,960 --> 00:09:01,060
‫final, y también cómo puede iniciar sesión, de acuerdo.

158
00:09:01,060 --> 00:09:02,760
‫O también puede

159
00:09:02,760 --> 00:09:06,290
‫describir eso aquí en la sección de autenticación, ¿verdad?

160
00:09:06,290 --> 00:09:09,243
‫Entonces, idealmente, tendrías descripciones para todo esto.

161
00:09:10,360 --> 00:09:11,948
‫Ah, y aquí veo

162
00:09:11,948 --> 00:09:15,770
‫que en realidad nos olvidamos de reemplazar la contraseña real,

163
00:09:15,770 --> 00:09:19,940
‫pero no importa, ya que esto es solo un ejemplo, ¿de acuerdo?

164
00:09:19,940 --> 00:09:22,040
‫Pero, por supuesto, obtienes todas

165
00:09:22,040 --> 00:09:24,933
‫las solicitudes que teníamos en nuestro cartero también aquí.

166
00:09:26,900 --> 00:09:30,780
‫Ahora, otra característica interesante aquí es que se ejecuta en el botón

167
00:09:30,780 --> 00:09:33,830
‫Postman, por lo que si alguien tiene Postman instalado en

168
00:09:33,830 --> 00:09:36,380
‫su computadora, todo lo que necesita hacer

169
00:09:36,380 --> 00:09:40,000
‫es hacer clic aquí y luego abrir con su aplicación Postman.

170
00:09:40,000 --> 00:09:42,490
‫Ahora no voy a hacer eso en este

171
00:09:42,490 --> 00:09:45,830
‫momento porque, por supuesto, ya lo tengo en mi Postman, pero por

172
00:09:45,830 --> 00:09:49,270
‫lo demás, esta es una característica realmente agradable para que los usuarios sigan

173
00:09:49,270 --> 00:09:52,253
‫adelante y comiencen a experimentar con su API de inmediato.

174
00:09:54,070 --> 00:09:57,370
‫De acuerdo, y creo que eso es todo, así

175
00:09:57,370 --> 00:09:59,330
‫que esto concluye nuestra

176
00:09:59,330 --> 00:10:02,610
‫sección y nuestra API ahora finalmente está realmente completa.

177
00:10:02,610 --> 00:10:06,440
‫Nuevamente, felicitaciones por llegar tan lejos en el

178
00:10:06,440 --> 00:10:08,720
‫curso, ya hemos

179
00:10:08,720 --> 00:10:11,140
‫cubierto mucho terreno aquí juntos.

180
00:10:11,140 --> 00:10:14,230
‫Ahora, a continuación, hay una sección muy, muy emocionante por

181
00:10:14,230 --> 00:10:16,460
‫delante donde finalmente crearemos la cara

182
00:10:16,460 --> 00:10:19,260
‫del usuario para el sitio web de Natours.

183
00:10:19,260 --> 00:10:21,510
‫Entonces, básicamente, usaremos plantillas para

184
00:10:21,510 --> 00:10:24,770
‫crear un sitio web completamente dinámico basado en todos los

185
00:10:24,770 --> 00:10:27,810
‫datos que ya tenemos en nuestra base de datos.

186
00:10:27,810 --> 00:10:29,380
‫Y eso es realmente genial.

187
00:10:29,380 --> 00:10:32,053
‫Y no puedo esperar para mostrártelo.