POSTMAN

Bagaimana Cara Menginstall Postman?

1. Pertama, kita kunjungi website postman https://www.postman.com/

Pada bagian kiri bawah terdapat keterangan download, pilih Postman sesuai sistem operasi device kamu. Kemudian klik Download

2. Selesai mengunduh buka file installer, kemudian double klik pada file tersebut dan tunggu hingga proses instalasi selesai
3. Selanjutnya kita akan membuat akun

Klik sign in

4. Jika sudah, seperti ini tampilan dari Postman

 

 

Bagaimana Cara Mengkonfigurasi Postman?[1] [2] 

1. Membuat Collection

Untuk menampung request pada API yang telah dibuat kita dapat menggunakan collection. Selain itu, dapat digunakan untuk spesifikasi pada request.

Untuk membuat collection baru, cukup klik button (+) kemudian berikan nama seperti contoh di atas

2. Melakukan Request

Pertama pilih add to request

Kali ini, kita menggunakan API JSON Placeholder

Kemudian, kita berikan nama request Get all posts, dengan menggunakan method GETdan url https://jsonplaceholder.typicode.com/posts

Selanjutnya tekan send atau klik enter pada keyboard kamu

Kita juga bisa membuat request baru dengan nama Create new post pada koleksi "Postman Training" menggunakan metode POST dengan alamat URL https://jsonplaceholder.typicode.com/posts . Pada opsi dropdown "Params", pilih "Body" untuk mengisi data post yang akan ditambahkan. Pilih jenis body "raw" dan pilih format "JSON".

Selanjutnya pada bagian Body kita isi dengan data berikut

Terakhir klik Send atau Enter pada keyboard kamu untuk mengirim data tersebut dan tampilannya akan seperti gambar dibawah ini.

3. Membuat Variabel

Sebelum membuat variabel, kita akan membuat request baru dengan nama Get post by id di dalam collection Postman Training. Dengan URL https://jsonplaceholder.typicode.com/posts/1

Untuk membuat variabel, pertama kita buka collection dan pilih variables. Kemudian kita tambahkan variabel baru dengan nama postId, dengan initial value dan current value adalah 1. Klik Ctrl+S untuk menyimpan.

Gunakan sintaks dibawah ini untuk mengakses variabel

Buka request Get post by id lalu gunakan variabel postId yang telah dibuat. Karena menggunakan variabel maka alamat url menjadi https://jsonplaceholder.typicode.com/posts/{{postId}}

4. Menambahkan Header Untuk Autentikasi

Sebuah request membutuhkan autentikasi dengan jenis Bearer Token, maka akan ditambahkan pada Authorization. Nilai token akan disimpan pada variabel userToken.

Menu Authorization ada pada dropdown Params

 

 

5. Melakukan Pengujian

Berikut ini adalah contoh kode untuk menguji permintaan "Get all posts" pada koleksi "Postman Training". Untuk mengakses kode pengujian tersebut, pilih opsi "Tests" pada dropdown "Params".

Beberapa pengujian yang dilakukan pada permintaan tersebut adalah:

●        Memastikan bahwa kode status respons adalah 200.

●        Memastikan bahwa response berupa data JSON.

●        Memastikan bahwa respons adalah sebuah array.

●        Memastikan bahwa data dalam respons berisi array dengan jumlah data minimal 1.

Berikut adalah contoh kode yang dapat ditulis pada bagian "Tests":

Kemudian klik Send atau Ctrl+Enter

6. Membuat Dokumentasi API

Klik View Documentation untuk melihat dokumentasi API pada collection

Gambar dibawah ini merupakan tampilan dokumentasi API pada collection Postman Training

Tombol pensil ini dapat kita gunakan untuk mengedit

Dibawah ini adalah deskripsi untuk request Get all post

Kemudian klik save untuk menyimpan

Jika ingin membuat deskripsi untuk request lain gunakan create new post dan Get post by id seperti contoh dibawah ini

Untuk melihat tampilan dokumen, kita klik publish seperti ini

Kemudian pilih Preview Documentation

Maka, inilah tampilannya

Kali ini kita akan membuat request menggunakan cURL

Disini kita dapat memilih bahasa pemrograman apa yang ingin digunakan

Kali ini kita memilih menggunakan Javascript untuk request Get all post, maka otomatis menggunakan bahasa yang sudah kita pilih sebelumnya.

Kemudian kita klik Publish Collection jika kita ingin mempublish

Terakhir kita klik View Documentation, maka tampilannya akan seperti gambar dibawah ini.

7. Environment

a.       Membuat Environment

Pilih nama environment untuk membuka editor

Ikon tampilan cepat environment berada di sebelah pemilih environment yang mencantumkan variabel untuk environment aktif dan variabel global apa pun yang telah kita bagikan.

Sekarang, kita akan membuat environment ikuti langkah berikut ini ya!

●        Berikan nama environment kamu, dan inisialisasi dengan variabel apa pun yang diperlukan. Kamu juga bisa menentukan variabel untuk environment nanti. Jangan lupa klik simpan

b.      Menambahkan Variabel Environment

Kita dapat menambah variabel environment dengan membuka environment dari sidebar dan mengeditnya pada tab tersebut.

Edit nama dan nilai variabel sebaris, atau gunakan ikon tutup ikon untuk menghapus variabel. Masukkan nama dan nilai untuk variabel baru pada baris baru. Jangan lupa klik simpan.

c.       Mengakses Environment

Kita bisa mengambil semua variabel environment dari Postman, termasuk URL, parameter, data isi, dan skrip pengujian. Untuk melihat daftar semua lingkungan Anda, cukup klik pada opsi "Lingkungan" di sidebar.

Di sini, kita memiliki berbagai opsi untuk mengelola environment bersama dalam ruang kerja. kita bisa menambah, membagikan, menggandakan, mengunduh, mengelola akses, menghapus, dan menghapus lingkungan bersama. Selain itu, kita bisa mengakses variabel global Anda dengan mengklik pada opsi "Globals".

Untuk melihat variabel dalam environment tertentu, cukup pilih nama lingkungannya. Kita bisa mengedit, menambah, dan menghapus variabel dari lingkungan tersebut di halaman ini. Jika kita ingin mencari variabel tertentu, kita bisa menggunakan kontrol Filter untuk memudahkan proses pencarian.

d.      Memilih Environment Aktif

Untuk menggunakan value dari variabel environment dalam request, rujuk dengan nama dan berada dalam kurung kurawal ganda.

Kita dapat menggunakan notasi variabel yang sama di URL permintaan, parameter, header, dan data isi.

Kita dapat mengakses nilai variabel lingkungan saat ini di kode Pra-permintaan dan Tes Anda.

e.       Mengedit Variabel Environment

Kita hanya bisa mengedit environment tempat kita memiliki akses editor

Edit nama lingkungan, atau nama, jenis , dan nilai variabel kita. Perlu diingat jika nilai awal akan disinkronkan dengan akun Postman kita dan dibagikan dengan kolaborator yang memiliki akses. Jika pengeditan selesai, klik simpan

Kita juga bisa memperbarui nilai variabel environment dari skrip pengujian

f.        Mengatur Variabel Environment

Gunakan pm.environment untuk menyetel variabel lingkungan di lingkungan aktif (yang dipilih saat ini):

g.      Bekerja Dengan Environment Sebagai Tim

Pilih ruang kerja, kemudian pindahkan environment

Untuk mengelola peran, klik kelola peran

Klik ekspor jika ingin mengekspor environment

h.      Meminta Akses Environment

Jika kita hanya memiliki akses baca saja, kita bisa meminta akses edit. Caranya klik Environment kemudian Minta Akses.

 

 

Referensi

1. https://kotakode.com/blogs/16235/Panduan-Singkat-Menggunakan-Postman
2. https://learning.postman.com/docs/sending-requests/managing-environments/