‫Narator: Jadi, API kita pada dasarnya sudah selesai.
‫Jadi di video terakhir
‫bagian ini, kita akan segera
‫membuat dokumentasi untuk API langsung di Postman.
‫Dan itu benar, kita dapat
‫dengan mudah membuat beberapa dokumentasi cepat langsung di Postman.
‫Dan sangat penting untuk memiliki dokumentasi
‫API karena ini adalah cara kami berkomunikasi dengan anggota tim,
‫atau bahkan pengguna akhir API kami, bagaimana mereka
‫benar-benar dapat menggunakannya dalam praktik.
‫Jadi izinkan saya sekarang menunjukkan cara kerjanya.
‫Sekarang sebelum kita benar-benar dapat membuat dokumentasi,
‫mari lakukan pembersihan di sini.
‫Misalnya, singkirkan permintaan ini, oke?
‫Hal lain yang ingin saya lakukan adalah di sini di titik
‫masuk, kami benar-benar mengungkapkan kata sandi kami di sini.
‫Dan itu bukan ide yang baik, jadi yang akan
‫saya lakukan adalah membuat variabel lingkungan yang
‫akan menyimpan kata sandi ini.
‫Karena itu selalu sama yang seharusnya tidak ada masalah.
‫Jadi, ingat bagaimana kita melakukannya.
‫Nah kami datang ke sini untuk mengelola lingkungan
‫dan jadi di sini kami hanya menambahkan satu lagi.
‫Jadi kata sandi, test1234.
‫Dan di sini ini tidak benar, jadi kata sandi, perbarui, dan sekarang, mari kita lakukan
‫hal yang sama di sini
‫di produksi juga.
‫Jadi kata sandi, test1234.
‫Jadi, bukan menambahkan, tapi mari kita tutup itu dan
‫jadi di sini sekarang saya bisa menambahkan dan menggunakannya,
‫bukan dalam string, tapi seperti ini.
‫Jadi kata sandi.
‫Jadi mari kita coba itu.
‫Dan ini memberi kita kesalahan aneh ini, tetapi kata
‫sandi kita sebenarnya ada di sini jadi
‫mungkin yang perlu kita lakukan adalah benar-benar memberi tanda kutip di sini.
‫Jadi mari kita coba itu.
‫Dan sekarang memang kita sudah berhasil login.
‫Jadi simpan itu sekarang, oke?
‫Jadi sekarang yang harus kita lakukan adalah membuat
‫deskripsi untuk setiap permintaan yang kita
‫miliki dalam koleksi kita.
‫Sekarang tentu saja saya tidak akan
‫melakukan itu, saya hanya akan mencontohkannya di sini dengan yang pertama.
‫Oke?
‫Jadi mari kita tutup yang lain
‫ini dan sekarang di sini kita bisa menambahkan deskripsi.
‫Jadi katakan saja, gunakan titik akhir
‫ini untuk membuat tur baru.
‫Oke, dan sekali lagi, Anda sekarang harus melakukan hal yang sama persis
‫untuk semua permintaan Anda jika tujuan Anda adalah untuk benar-benar
‫memublikasikan dan membagikan API Anda, oke?
‫Kemudian hal yang sama berlaku untuk folder, dan
‫untuk tidak mengganti nama, tetapi untuk mengedit.
‫Jadi di setiap
‫folder ini sebenarnya kita juga bisa menambahkan deskripsi.
‫Jadi katakan saja, sesuatu yang acak seperti,
‫Anda bisa mendapatkan semua tur, membuat
‫yang baru,
‫dan mengedit serta menghapus tur.
‫Ada juga titik akhir khusus untuk beberapa
‫persyaratan khusus.
‫Oke, lagi dan lagi ini benar-benar acak
‫dan saya akan menerbitkan sesuatu seperti ini untuk API saya sendiri,
‫tapi di sini kami benar-benar hanya ingin menguji cara kerjanya, oke?
‫Seperti yang Anda lihat
‫di sini, Anda juga dapat menggunakan Tandai di sini, oke?
‫Jadi misalnya, untuk membuat teks tebal,
‫Anda dapat berpikir itu berfungsi seperti ini, ya
‫sepertinya memang begitu, dan
‫ya, Anda bisa melakukan segala macam hal di sini, oke?
‫Anda juga mungkin
‫dapat membuat deskripsi di
‫Natours itu sendiri, jadi katakanlah, Natours API
‫berisi titik akhir untuk tur, pengguna, dan ulasan.
‫Dan sekali lagi
‫banyak hal, seperti Anda dapat menjelaskan proses otentikasi
‫Anda, atau izin Anda dan benar-benar semua
‫yang perlu diketahui pengguna untuk menggunakan API ini, oke?
‫Jadi Anda harus
‫selalu menambahkan deskripsi ke semua permintaan, ke semua
‫folder dan juga, tentu saja, koleksi itu sendiri.
‫Oh, dan kita sebenarnya bisa mendeskripsikan parameter kueri dalam string kueri,
‫jadi mari kita lakukan di sini.
‫Dan kita juga bisa mengatakan itu mendukung lebih
‫besar dari, kurang dari sama, lebih besar dari dan kurang dari operator.
‫Jadi sekali lagi, hanya sebuah contoh
‫di sini dan mari kita simpan sekarang ke permintaan.
‫Jadi dengan ini saya pikir
‫kita harus siap untuk benar-benar mempublikasikan dokumentasi API kita.
‫Dan untuk melakukan itu, mari kita pergi
‫ke sini ke opsi koleksi, dan kemudian
‫di sini, publikasikan dokumentasi.
‫Dan itu kemudian akan membuka jendela browser, dan bagi
‫saya itu terjadi di luar layar
‫saya, jadi biarkan saya mendapatkannya di sini.
‫Dan sekarang Anda dapat memilih lingkungan.
‫Jadi di sini kita harus memiliki daftar lingkungan kita,
‫yang untuk beberapa alasan tidak kita miliki, itu aneh, tapi bagaimanapun,
‫kita tidak ingin menggunakan lingkungan apapun, karena itu akan
‫menggantikan variabel lingkungan
‫kita dengan nilai sebenarnya, dan kami tidak
‫menginginkan itu.
‫Misalnya kita menggunakan variabel environment
‫pada password, sehingga
‫nanti di dokumentasi tidak terlalu terlihat ya?
‫Jadi kami benar-benar ingin tidak menggunakan lingkungan.
‫Sekarang kita juga bisa
‫menggunakan domain kustom, tapi itu hanya untuk pengguna berbayar, oke?
‫Kemudian kami juga dapat mengubah semua gaya
‫API agar sesuai dengan warna merek Anda, tetapi sekali
‫lagi, itu tidak perlu dalam
‫kasus ini, jadi, mari kita lanjutkan dan publikasikan.
‫Dan sekarang, ini sebenarnya publik,
‫jadi semua orang dapat melihat dokumentasi Anda sekarang di URL ini.
‫Sekarang untuk beberapa alasan itu tidak benar-benar memperbarui semua perubahan yang
‫baru saja kita lakukan sebelumnya, jadi itu agak aneh.
‫Jadi mari kita kembali ke Postman dan
‫melihat apa yang terjadi.
‫Mungkin ini ada hubungannya dengan hal yang berputar di sini, jadi saya
‫akan keluar dari Postman dan membukanya lagi.
‫Dan mari berharap itu memperbaikinya.
‫Jadi jika kita sekarang memuat ulang di
‫sini, ahh maka kita mendapatkan semua perubahan kita sebenarnya di sini.
‫Jadi Anda lihat, deskripsi yang
‫kami tambahkan untuk koleksi Natours, oke?
‫Kemudian juga deskripsi untuk folder ini,
‫dan deskripsi untuk permintaan ini.
‫Dan terakhir, sebagai deskripsi
‫pertama, juga untuk parameter ini, oke?
‫Di sini kita kemudian mendapatkan variabel lingkungan URL
‫alih-alih URL yang sebenarnya.
‫Sekarang tentu saja, Anda mungkin ingin benar-benar memberikan
‫URL asli di sini dan
‫untuk itu Anda cukup menggunakan lingkungan lain.
‫Jadi di sini Anda benar-benar dapat melihat semua
‫lingkungan tetapi bersifat pribadi, jadi saat ini tidak ada yang dapat
‫menggunakannya, tetapi ingat
‫bagaimana pada langkah pertama, kami sebenarnya dapat
‫membuat dokumentasi ini menggunakan salah satu lingkungan, dan mungkin
‫kami akan melakukannya telah menggunakan lingkungan produksi untuk
‫itu dan dengan itu kami akan memiliki URL produksi
‫akhir di sini di URL API kami, oke?
‫Bagaimanapun, ini adalah bagaimana dokumentasi
‫terlihat, jadi ini adalah contoh permintaan dan kita
‫dapat mengubahnya juga ke bahasa kita sendiri.
‫Jadi dalam hal ini Node
‫JS, tetapi jika pengguna misalnya melakukan permintaan
‫menggunakan jQuery, maka mereka dapat menggunakan jQuery saja, oke.
‫Jadi hanya untuk melihat permintaan contoh ini di sini, jadi dengan Node,
‫tampilannya seperti ini.
‫Jadi, di sini kami memiliki semua
‫titik akhir kami dan Anda dapat melihat bahwa yang memerlukan
‫otentikasi, mereka sebenarnya memiliki ikon kunci ini di sini.
‫Jadi dalam deskripsi Anda, sekarang Anda dapat
‫menambahkan bahwa Anda perlu masuk, untuk mengakses titik akhir ini,
‫dan juga bagaimana Anda benar-benar dapat masuk, oke.
‫Atau Anda juga
‫bisa menjelaskannya di sini di bagian otentikasi, bukan?
‫Jadi idealnya, Anda akan memiliki deskripsi untuk semua ini.
‫Oh, dan di sini
‫saya melihat bahwa kami benar-benar lupa untuk mengganti kata sandi
‫yang sebenarnya tetapi tidak apa-apa karena ini hanya beberapa contoh, oke?
‫Tapi tentu saja, Anda mendapatkan semua
‫permintaan yang kami miliki di Postman kami juga di sini.
‫Sekarang fitur bagus lainnya di sini adalah tombol run in Postman,
‫dan jika seseorang telah menginstal Postman di komputer
‫mereka, yang perlu mereka lakukan hanyalah
‫mengklik di sini dan kemudian membuka dengan aplikasi Postman mereka.
‫Sekarang saya tidak akan melakukannya sekarang
‫karena tentu saja, saya sudah memilikinya di Postman saya, tetapi
‫selain itu ini adalah fitur yang sangat bagus bagi pengguna untuk
‫kemudian melanjutkan dan segera mulai bereksperimen dengan API Anda.
‫Oke, dan saya pikir itu saja, jadi
‫ini menyelesaikan bagian kita
‫dan API kita sekarang akhirnya benar-benar selesai.
‫Jadi sekali lagi, selamat karena telah mencapai sejauh
‫ini, kita telah membahas
‫banyak hal di sini bersama-sama.
‫Sekarang selanjutnya, ada bagian yang sangat, sangat menarik di
‫depan di mana kita akhirnya
‫akan membangun wajah pengguna untuk situs web Natours.
‫Jadi pada dasarnya, kita akan
‫menggunakan template untuk membuat situs web yang sepenuhnya dinamis berdasarkan
‫semua data yang sudah kita miliki di database kita.
‫Dan itu sangat keren.
‫Jadi saya tidak sabar untuk menunjukkannya kepada Anda.