1
00:00:01,100 --> 00:00:04,510
‫Narator: Jadi, API kita pada dasarnya sudah selesai.

2
00:00:04,510 --> 00:00:07,003
‫Jadi di video terakhir

3
00:00:07,003 --> 00:00:09,680
‫bagian ini, kita akan segera

4
00:00:09,680 --> 00:00:13,020
‫membuat dokumentasi untuk API langsung di Postman.

5
00:00:13,020 --> 00:00:15,290
‫Dan itu benar, kita dapat

6
00:00:15,290 --> 00:00:18,830
‫dengan mudah membuat beberapa dokumentasi cepat langsung di Postman.

7
00:00:18,830 --> 00:00:21,620
‫Dan sangat penting untuk memiliki dokumentasi

8
00:00:21,620 --> 00:00:25,870
‫API karena ini adalah cara kami berkomunikasi dengan anggota tim,

9
00:00:25,870 --> 00:00:29,140
‫atau bahkan pengguna akhir API kami, bagaimana mereka

10
00:00:29,140 --> 00:00:31,740
‫benar-benar dapat menggunakannya dalam praktik.

11
00:00:31,740 --> 00:00:33,973
‫Jadi izinkan saya sekarang menunjukkan cara kerjanya.

12
00:00:35,490 --> 00:00:38,367
‫Sekarang sebelum kita benar-benar dapat membuat dokumentasi,

13
00:00:38,367 --> 00:00:40,920
‫mari lakukan pembersihan di sini.

14
00:00:40,920 --> 00:00:45,010
‫Misalnya, singkirkan permintaan ini, oke?

15
00:00:47,550 --> 00:00:51,490
‫Hal lain yang ingin saya lakukan adalah di sini di titik

16
00:00:51,490 --> 00:00:55,180
‫masuk, kami benar-benar mengungkapkan kata sandi kami di sini.

17
00:00:55,180 --> 00:00:58,220
‫Dan itu bukan ide yang baik, jadi yang akan

18
00:00:58,220 --> 00:01:00,350
‫saya lakukan adalah membuat variabel lingkungan yang

19
00:01:00,350 --> 00:01:02,320
‫akan menyimpan kata sandi ini.

20
00:01:02,320 --> 00:01:06,100
‫Karena itu selalu sama yang seharusnya tidak ada masalah.

21
00:01:06,100 --> 00:01:07,833
‫Jadi, ingat bagaimana kita melakukannya.

22
00:01:09,920 --> 00:01:12,730
‫Nah kami datang ke sini untuk mengelola lingkungan

23
00:01:13,970 --> 00:01:16,903
‫dan jadi di sini kami hanya menambahkan satu lagi.

24
00:01:17,960 --> 00:01:19,807
‫Jadi kata sandi, test1234.

25
00:01:23,820 --> 00:01:28,820
‫Dan di sini ini tidak benar, jadi kata sandi, perbarui, dan sekarang, mari kita lakukan

26
00:01:30,220 --> 00:01:31,860
‫hal yang sama di sini

27
00:01:31,860 --> 00:01:33,363
‫di produksi juga.

28
00:01:35,440 --> 00:01:37,297
‫Jadi kata sandi, test1234.

29
00:01:41,020 --> 00:01:46,020
‫Jadi, bukan menambahkan, tapi mari kita tutup itu dan

30
00:01:46,590 --> 00:01:51,120
‫jadi di sini sekarang saya bisa menambahkan dan menggunakannya,

31
00:01:51,120 --> 00:01:55,003
‫bukan dalam string, tapi seperti ini.

32
00:01:56,840 --> 00:01:58,490
‫Jadi kata sandi.

33
00:01:58,490 --> 00:01:59,633
‫Jadi mari kita coba itu.

34
00:02:00,980 --> 00:02:04,620
‫Dan ini memberi kita kesalahan aneh ini, tetapi kata

35
00:02:04,620 --> 00:02:07,840
‫sandi kita sebenarnya ada di sini jadi

36
00:02:07,840 --> 00:02:12,313
‫mungkin yang perlu kita lakukan adalah benar-benar memberi tanda kutip di sini.

37
00:02:13,360 --> 00:02:14,680
‫Jadi mari kita coba itu.

38
00:02:14,680 --> 00:02:17,740
‫Dan sekarang memang kita sudah berhasil login.

39
00:02:17,740 --> 00:02:21,090
‫Jadi simpan itu sekarang, oke?

40
00:02:21,090 --> 00:02:23,990
‫Jadi sekarang yang harus kita lakukan adalah membuat

41
00:02:23,990 --> 00:02:26,290
‫deskripsi untuk setiap permintaan yang kita

42
00:02:26,290 --> 00:02:28,150
‫miliki dalam koleksi kita.

43
00:02:28,150 --> 00:02:30,120
‫Sekarang tentu saja saya tidak akan

44
00:02:30,120 --> 00:02:33,173
‫melakukan itu, saya hanya akan mencontohkannya di sini dengan yang pertama.

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

46
00:02:36,630 --> 00:02:39,250
‫Jadi mari kita tutup yang lain

47
00:02:39,250 --> 00:02:42,840
‫ini dan sekarang di sini kita bisa menambahkan deskripsi.

48
00:02:42,840 --> 00:02:46,350
‫Jadi katakan saja, gunakan titik akhir

49
00:02:49,150 --> 00:02:52,403
‫ini untuk membuat tur baru.

50
00:02:53,530 --> 00:02:58,514
‫Oke, dan sekali lagi, Anda sekarang harus melakukan hal yang sama persis

51
00:02:58,514 --> 00:03:03,030
‫untuk semua permintaan Anda jika tujuan Anda adalah untuk benar-benar

52
00:03:03,030 --> 00:03:06,170
‫memublikasikan dan membagikan API Anda, oke?

53
00:03:06,170 --> 00:03:09,633
‫Kemudian hal yang sama berlaku untuk folder, dan

54
00:03:11,130 --> 00:03:14,300
‫untuk tidak mengganti nama, tetapi untuk mengedit.

55
00:03:14,300 --> 00:03:15,900
‫Jadi di setiap

56
00:03:15,900 --> 00:03:18,870
‫folder ini sebenarnya kita juga bisa menambahkan deskripsi.

57
00:03:18,870 --> 00:03:23,380
‫Jadi katakan saja, sesuatu yang acak seperti,

58
00:03:23,380 --> 00:03:27,093
‫Anda bisa mendapatkan semua tur, membuat

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

60
00:03:31,400 --> 00:03:34,743
‫dan mengedit serta menghapus tur.

61
00:03:36,580 --> 00:03:41,000
‫Ada juga titik akhir khusus untuk beberapa

62
00:03:42,630 --> 00:03:44,763
‫persyaratan khusus.

63
00:03:46,170 --> 00:03:48,680
‫Oke, lagi dan lagi ini benar-benar acak

64
00:03:48,680 --> 00:03:52,350
‫dan saya akan menerbitkan sesuatu seperti ini untuk API saya sendiri,

65
00:03:52,350 --> 00:03:56,100
‫tapi di sini kami benar-benar hanya ingin menguji cara kerjanya, oke?

66
00:03:56,100 --> 00:03:57,540
‫Seperti yang Anda lihat

67
00:03:57,540 --> 00:04:00,800
‫di sini, Anda juga dapat menggunakan Tandai di sini, oke?

68
00:04:00,800 --> 00:04:03,240
‫Jadi misalnya, untuk membuat teks tebal,

69
00:04:03,240 --> 00:04:06,273
‫Anda dapat berpikir itu berfungsi seperti ini, ya

70
00:04:07,820 --> 00:04:09,920
‫sepertinya memang begitu, dan

71
00:04:09,920 --> 00:04:13,523
‫ya, Anda bisa melakukan segala macam hal di sini, oke?

72
00:04:15,970 --> 00:04:18,730
‫Anda juga mungkin

73
00:04:18,730 --> 00:04:21,500
‫dapat membuat deskripsi di

74
00:04:21,500 --> 00:04:26,363
‫Natours itu sendiri, jadi katakanlah, Natours API

75
00:04:30,950 --> 00:04:35,950
‫berisi titik akhir untuk tur, pengguna, dan ulasan.

76
00:04:37,790 --> 00:04:39,510
‫Dan sekali lagi

77
00:04:39,510 --> 00:04:42,500
‫banyak hal, seperti Anda dapat menjelaskan proses otentikasi

78
00:04:42,500 --> 00:04:45,320
‫Anda, atau izin Anda dan benar-benar semua

79
00:04:45,320 --> 00:04:48,820
‫yang perlu diketahui pengguna untuk menggunakan API ini, oke?

80
00:04:48,820 --> 00:04:50,510
‫Jadi Anda harus

81
00:04:50,510 --> 00:04:54,060
‫selalu menambahkan deskripsi ke semua permintaan, ke semua

82
00:04:54,060 --> 00:04:57,490
‫folder dan juga, tentu saja, koleksi itu sendiri.

83
00:04:57,490 --> 00:05:01,510
‫Oh, dan kita sebenarnya bisa mendeskripsikan parameter kueri dalam string kueri,

84
00:05:01,510 --> 00:05:03,943
‫jadi mari kita lakukan di sini.

85
00:05:09,634 --> 00:05:13,384
‫Dan kita juga bisa mengatakan itu mendukung lebih

86
00:05:14,620 --> 00:05:19,620
‫besar dari, kurang dari sama, lebih besar dari dan kurang dari operator.

87
00:05:23,070 --> 00:05:24,890
‫Jadi sekali lagi, hanya sebuah contoh

88
00:05:26,070 --> 00:05:28,490
‫di sini dan mari kita simpan sekarang ke permintaan.

89
00:05:28,490 --> 00:05:30,580
‫Jadi dengan ini saya pikir

90
00:05:30,580 --> 00:05:33,700
‫kita harus siap untuk benar-benar mempublikasikan dokumentasi API kita.

91
00:05:33,700 --> 00:05:36,750
‫Dan untuk melakukan itu, mari kita pergi

92
00:05:36,750 --> 00:05:39,910
‫ke sini ke opsi koleksi, dan kemudian

93
00:05:39,910 --> 00:05:42,070
‫di sini, publikasikan dokumentasi.

94
00:05:42,070 --> 00:05:45,400
‫Dan itu kemudian akan membuka jendela browser, dan bagi

95
00:05:45,400 --> 00:05:47,830
‫saya itu terjadi di luar layar

96
00:05:47,830 --> 00:05:50,570
‫saya, jadi biarkan saya mendapatkannya di sini.

97
00:05:50,570 --> 00:05:53,700
‫Dan sekarang Anda dapat memilih lingkungan.

98
00:05:53,700 --> 00:05:57,200
‫Jadi di sini kita harus memiliki daftar lingkungan kita,

99
00:05:57,200 --> 00:06:01,470
‫yang untuk beberapa alasan tidak kita miliki, itu aneh, tapi bagaimanapun,

100
00:06:01,470 --> 00:06:05,060
‫kita tidak ingin menggunakan lingkungan apapun, karena itu akan

101
00:06:05,060 --> 00:06:06,540
‫menggantikan variabel lingkungan

102
00:06:06,540 --> 00:06:09,340
‫kita dengan nilai sebenarnya, dan kami tidak

103
00:06:09,340 --> 00:06:10,460
‫menginginkan itu.

104
00:06:10,460 --> 00:06:12,620
‫Misalnya kita menggunakan variabel environment

105
00:06:12,620 --> 00:06:14,620
‫pada password, sehingga

106
00:06:14,620 --> 00:06:17,900
‫nanti di dokumentasi tidak terlalu terlihat ya?

107
00:06:17,900 --> 00:06:20,313
‫Jadi kami benar-benar ingin tidak menggunakan lingkungan.

108
00:06:21,270 --> 00:06:23,280
‫Sekarang kita juga bisa

109
00:06:23,280 --> 00:06:27,610
‫menggunakan domain kustom, tapi itu hanya untuk pengguna berbayar, oke?

110
00:06:27,610 --> 00:06:30,740
‫Kemudian kami juga dapat mengubah semua gaya

111
00:06:30,740 --> 00:06:34,410
‫API agar sesuai dengan warna merek Anda, tetapi sekali

112
00:06:34,410 --> 00:06:37,260
‫lagi, itu tidak perlu dalam

113
00:06:37,260 --> 00:06:40,620
‫kasus ini, jadi, mari kita lanjutkan dan publikasikan.

114
00:06:40,620 --> 00:06:42,550
‫Dan sekarang, ini sebenarnya publik,

115
00:06:42,550 --> 00:06:46,367
‫jadi semua orang dapat melihat dokumentasi Anda sekarang di URL ini.

116
00:06:47,480 --> 00:06:51,300
‫Sekarang untuk beberapa alasan itu tidak benar-benar memperbarui semua perubahan yang

117
00:06:51,300 --> 00:06:54,653
‫baru saja kita lakukan sebelumnya, jadi itu agak aneh.

118
00:06:55,510 --> 00:06:58,420
‫Jadi mari kita kembali ke Postman dan

119
00:06:58,420 --> 00:07:00,090
‫melihat apa yang terjadi.

120
00:07:00,090 --> 00:07:04,510
‫Mungkin ini ada hubungannya dengan hal yang berputar di sini, jadi saya

121
00:07:04,510 --> 00:07:07,158
‫akan keluar dari Postman dan membukanya lagi.

122
00:07:07,158 --> 00:07:09,393
‫Dan mari berharap itu memperbaikinya.

123
00:07:12,610 --> 00:07:15,060
‫Jadi jika kita sekarang memuat ulang di

124
00:07:15,060 --> 00:07:18,720
‫sini, ahh maka kita mendapatkan semua perubahan kita sebenarnya di sini.

125
00:07:18,720 --> 00:07:20,980
‫Jadi Anda lihat, deskripsi yang

126
00:07:20,980 --> 00:07:23,620
‫kami tambahkan untuk koleksi Natours, oke?

127
00:07:23,620 --> 00:07:26,830
‫Kemudian juga deskripsi untuk folder ini,

128
00:07:26,830 --> 00:07:29,530
‫dan deskripsi untuk permintaan ini.

129
00:07:29,530 --> 00:07:32,180
‫Dan terakhir, sebagai deskripsi

130
00:07:32,180 --> 00:07:35,400
‫pertama, juga untuk parameter ini, oke?

131
00:07:35,400 --> 00:07:39,477
‫Di sini kita kemudian mendapatkan variabel lingkungan URL

132
00:07:39,477 --> 00:07:41,850
‫alih-alih URL yang sebenarnya.

133
00:07:41,850 --> 00:07:44,310
‫Sekarang tentu saja, Anda mungkin ingin benar-benar memberikan

134
00:07:44,310 --> 00:07:46,320
‫URL asli di sini dan

135
00:07:46,320 --> 00:07:48,443
‫untuk itu Anda cukup menggunakan lingkungan lain.

136
00:07:50,150 --> 00:07:53,170
‫Jadi di sini Anda benar-benar dapat melihat semua

137
00:07:53,170 --> 00:07:57,060
‫lingkungan tetapi bersifat pribadi, jadi saat ini tidak ada yang dapat

138
00:07:57,060 --> 00:07:58,720
‫menggunakannya, tetapi ingat

139
00:07:58,720 --> 00:08:01,430
‫bagaimana pada langkah pertama, kami sebenarnya dapat

140
00:08:01,430 --> 00:08:04,760
‫membuat dokumentasi ini menggunakan salah satu lingkungan, dan mungkin

141
00:08:04,760 --> 00:08:07,990
‫kami akan melakukannya telah menggunakan lingkungan produksi untuk

142
00:08:07,990 --> 00:08:11,350
‫itu dan dengan itu kami akan memiliki URL produksi

143
00:08:11,350 --> 00:08:14,543
‫akhir di sini di URL API kami, oke?

144
00:08:15,440 --> 00:08:18,064
‫Bagaimanapun, ini adalah bagaimana dokumentasi

145
00:08:18,064 --> 00:08:21,530
‫terlihat, jadi ini adalah contoh permintaan dan kita

146
00:08:21,530 --> 00:08:24,940
‫dapat mengubahnya juga ke bahasa kita sendiri.

147
00:08:24,940 --> 00:08:27,840
‫Jadi dalam hal ini Node

148
00:08:27,840 --> 00:08:31,020
‫JS, tetapi jika pengguna misalnya melakukan permintaan

149
00:08:31,020 --> 00:08:34,770
‫menggunakan jQuery, maka mereka dapat menggunakan jQuery saja, oke.

150
00:08:34,770 --> 00:08:39,290
‫Jadi hanya untuk melihat permintaan contoh ini di sini, jadi dengan Node,

151
00:08:39,290 --> 00:08:40,793
‫tampilannya seperti ini.

152
00:08:42,870 --> 00:08:45,213
‫Jadi, di sini kami memiliki semua

153
00:08:45,213 --> 00:08:48,400
‫titik akhir kami dan Anda dapat melihat bahwa yang memerlukan

154
00:08:48,400 --> 00:08:51,400
‫otentikasi, mereka sebenarnya memiliki ikon kunci ini di sini.

155
00:08:51,400 --> 00:08:54,299
‫Jadi dalam deskripsi Anda, sekarang Anda dapat

156
00:08:54,299 --> 00:08:57,960
‫menambahkan bahwa Anda perlu masuk, untuk mengakses titik akhir ini,

157
00:08:57,960 --> 00:09:01,060
‫dan juga bagaimana Anda benar-benar dapat masuk, oke.

158
00:09:01,060 --> 00:09:02,760
‫Atau Anda juga

159
00:09:02,760 --> 00:09:06,290
‫bisa menjelaskannya di sini di bagian otentikasi, bukan?

160
00:09:06,290 --> 00:09:09,243
‫Jadi idealnya, Anda akan memiliki deskripsi untuk semua ini.

161
00:09:10,360 --> 00:09:11,948
‫Oh, dan di sini

162
00:09:11,948 --> 00:09:15,770
‫saya melihat bahwa kami benar-benar lupa untuk mengganti kata sandi

163
00:09:15,770 --> 00:09:19,940
‫yang sebenarnya tetapi tidak apa-apa karena ini hanya beberapa contoh, oke?

164
00:09:19,940 --> 00:09:22,040
‫Tapi tentu saja, Anda mendapatkan semua

165
00:09:22,040 --> 00:09:24,933
‫permintaan yang kami miliki di Postman kami juga di sini.

166
00:09:26,900 --> 00:09:30,780
‫Sekarang fitur bagus lainnya di sini adalah tombol run in Postman,

167
00:09:30,780 --> 00:09:33,830
‫dan jika seseorang telah menginstal Postman di komputer

168
00:09:33,830 --> 00:09:36,380
‫mereka, yang perlu mereka lakukan hanyalah

169
00:09:36,380 --> 00:09:40,000
‫mengklik di sini dan kemudian membuka dengan aplikasi Postman mereka.

170
00:09:40,000 --> 00:09:42,490
‫Sekarang saya tidak akan melakukannya sekarang

171
00:09:42,490 --> 00:09:45,830
‫karena tentu saja, saya sudah memilikinya di Postman saya, tetapi

172
00:09:45,830 --> 00:09:49,270
‫selain itu ini adalah fitur yang sangat bagus bagi pengguna untuk

173
00:09:49,270 --> 00:09:52,253
‫kemudian melanjutkan dan segera mulai bereksperimen dengan API Anda.

174
00:09:54,070 --> 00:09:57,370
‫Oke, dan saya pikir itu saja, jadi

175
00:09:57,370 --> 00:09:59,330
‫ini menyelesaikan bagian kita

176
00:09:59,330 --> 00:10:02,610
‫dan API kita sekarang akhirnya benar-benar selesai.

177
00:10:02,610 --> 00:10:06,440
‫Jadi sekali lagi, selamat karena telah mencapai sejauh

178
00:10:06,440 --> 00:10:08,720
‫ini, kita telah membahas

179
00:10:08,720 --> 00:10:11,140
‫banyak hal di sini bersama-sama.

180
00:10:11,140 --> 00:10:14,230
‫Sekarang selanjutnya, ada bagian yang sangat, sangat menarik di

181
00:10:14,230 --> 00:10:16,460
‫depan di mana kita akhirnya

182
00:10:16,460 --> 00:10:19,260
‫akan membangun wajah pengguna untuk situs web Natours.

183
00:10:19,260 --> 00:10:21,510
‫Jadi pada dasarnya, kita akan

184
00:10:21,510 --> 00:10:24,770
‫menggunakan template untuk membuat situs web yang sepenuhnya dinamis berdasarkan

185
00:10:24,770 --> 00:10:27,810
‫semua data yang sudah kita miliki di database kita.

186
00:10:27,810 --> 00:10:29,380
‫Dan itu sangat keren.

187
00:10:29,380 --> 00:10:32,053
‫Jadi saya tidak sabar untuk menunjukkannya kepada Anda.