Panduan Pemula untuk Menguasai Pre-Scripts dalam Pengujian API: Hemat Waktu, Token, dan Repotnya

Anda adalah arsitek master LEGO.
Anda dipilih untuk membangun kota LEGO paling epik sepanjang masa — gedung pencakar langit, mobil terbang, jalan ajaib, bahkan kereta yang mengemudi sendiri yang mengelilingi puncak gunung.

Bunyinya seperti pekerjaan impian, kan?

Tapi tunggu dulu...
Apakah Anda benar-benar akan menuangkan semua batu bata di lantai dan mulai menumpuk secara acak?

Tidak mungkin.

Sebelum Anda bahkan menyambung dua bagian pertama, Anda akan memerlukan:

• Gambar kerja yang menunjukkan di mana semua bagian harus ditempatkan
• Peta untuk jalan, jembatan, dan terowongan
• Skema warna (tidak ada yang mau stasiun polisi berwarna ungu)
• Dan rencana daya agar kereta benar-benar berjalan

Karena tanpa itu, kota impian LEGO Anda akan menjadi kekacauan yang goyah dengan blok setengah jadi dan roda hilang.

Pengujian API itu persis sama.

Anda memiliki endpoint (potongan LEGO Anda), lingkungan (zona pembangunan Anda), token (seperti listrik), dan logika pengujian (peta Anda).

Jika Anda langsung terjun ke pengujian tanpa rencana, segalanya akan kacau. Cepat.

Variabel hilang, token kadaluarsa, header salah, dan Anda harus melakukan setup yang sama berulang kali.

Itulah peran pre-script.
Ini adalah gambar kerja yang menyiapkan kota pengujian Anda.

Ini memastikan semuanya berada di tempat yang tepat — sebelum pengujian Anda dimulai.
Jadi permintaan Anda tidak hanya terbang buta; mereka sepenuhnya dilengkapi, siap misi, dan dirancang untuk skala.

Kota LEGO (atau Pengujian API Anda) Membutuhkan Rencana

Anda sedang membangun kota LEGO yang besar dan rumit. Setiap potongan penting, setiap jalan harus tersambung, dan setiap bangunan memerlukan daya untuk berfungsi. Tanpa rencana, Anda hanya menumpuk batu bata secara acak, berharap semuanya muat bersama. Hal yang sama terjadi dalam pengujian API jika Anda melewati pre-script.

Menguji API tanpa pre-script seperti:

• Melupakan untuk mengatur token autentikasi
• Mengulangi langkah setup di setiap kasus pengujian
• Menyetel header atau parameter secara manual di setiap permintaan

Ini sangat menjengkelkan dan memakan waktu, dan percayalah, ini bukan cara paling efektif untuk menyelesaikan pekerjaan.

Bagaimana Menyiapkan Fondasi (Pre-Script)

Sekarang, tugas Anda di sini? Mudah! Sebelum Anda bahkan menyentuh endpoint API pertama, Anda perlu menyiapkan fondasi yang bersih dan dapat diulang.

Misi Anda:

• Definisikan variabel, seperti token autentikasi, ID pengguna, atau pengaturan khusus lingkungan.
• Atur konfigurasi global, seperti header atau jalur, yang berlaku untuk semua pengujian Anda.
• Automatiskan tugas berulang, sehingga Anda tidak perlu memasukkan informasi setup yang sama untuk setiap panggilan API.

Pikirkan ini seperti daftar pemeriksaan pra-pertunjukan: Pastikan semua aktor ada di tempat, panggung telah disiapkan, dan lampu telah dinyalakan, sebelum pertunjukan dimulai.

Dengan pre-script, Anda mengatur semua keajaiban di balik layar. Kereta tidak akan bergerak kecuali Anda telah menghidupkannya terlebih dahulu, kan?

Implementasikan Pre-Script Anda untuk Menyiapkan Panggung Pengujian

Sekarang inilah bagian yang menyenangkan.

Menulis pre-script Anda berarti menyiapkan segalanya untuk aksi — seperti pemanasan sebelum balapan.

Sebagai gantinya untuk mengulangi setup yang sama di setiap pengujian, Anda menulisnya sekali, dan itu akan dijalankan sebelum panggilan API sebenarnya Anda. Rapi, kan?

Mari kita lihat contoh dunia nyata ini, di mana kami login, mengambil token, dan menyimpannya agar tidak perlu melakukannya lagi di setiap pengujian.

Pre-Script Lengkap

// Pre-script untuk EchoAPI: Otomatisasi login dan setup token
if (!pm.environment.get("token")) {
  pm.sendRequest({
    url: "https://api.superapp.com/auth",
    method: "POST",
    header: {
      "Content-Type": "application/json"
    },
    body: {
      mode: "raw",
      raw: JSON.stringify({
        username: "apiuser",
        password: "supersecret"
      })
    }
  }, function (err, res) {
    const json = res.json();
    pm.environment.set("token", json.token);  // Simpan token secara global
    pm.environment.set("userId", json.user.id); // Simpan ID pengguna
  });
}

Penjelasan Langkah demi Langkah

1️⃣ Periksa Apakah Token Sudah Ada

if (!pm.environment.get("token")) {

Hanya jalankan permintaan login jika tidak ada token yang disimpan di lingkungan.
Ini menghindari permintaan login yang tidak perlu berulang kali — menghemat waktu dan mengurangi beban server.

2️⃣ Kirim Permintaan Login ke Endpoint Auth

pm.sendRequest({
  url: "https://api.superapp.com/auth",
  method: "POST",
  header: {
    "Content-Type": "application/json"
  },

Ini mengirim permintaan POST ke endpoint /auth API Anda, meminta token menggunakan kredensial login.
Pikirkan ini seperti mengatakan: "Halo server, ini nama pengguna dan kata sandi saya — tolong berikan kunci agar saya bisa masuk."

3️⃣ Tambahkan Kredensial Login dalam Format JSON

  body: {
    mode: "raw",
    raw: JSON.stringify({
      username: "apiuser",
      password: "supersecret"
    })
  }

Sebagian besar API mengharapkan kredensial sebagai JSON dalam body permintaan POST.
JSON.stringify() mengonversi informasi login menjadi format string JSON yang benar sebelum mengirimnya.

4️⃣ Tangani Respons dari Server

}, function (err, res) {
  const json = res.json();

Fungsi ini menunggu respons dan mengonversinya menjadi objek JSON menggunakan res.json().
Sekarang kita dapat dengan mudah mengekstrak informasi berguna dari respons seperti token dan userId.

5️⃣ Simpan Token untuk Digunakan Nanti

  pm.environment.set("token", json.token);

Ini menyimpan token ke dalam lingkungan.
Anda kemudian dapat merujuknya di permintaan mana pun menggunakan {{token}}, seperti ini:

Authorization: Bearer {{token}}

Ini berarti semua permintaan di masa depan akan otomatisotentikasi, tanpa harus login lagi.

6️⃣ Simpan ID Pengguna (Opsional tapi Berguna!)

  pm.environment.set("userId", json.user.id);

Dalam banyak API, Anda akan memerlukan ID pengguna untuk mendapatkan detail profil, memperbarui pengaturan, atau mengambil pesanan.
Menyimpannya sekarang akan menghemat waktu Anda nanti — tidak perlu mengkodingnya secara statis.

Inilah yang dilakukan pre-script ini:

✅ Memeriksa apakah Anda sudah memiliki token
✅ Jika tidak, login menggunakan kredensial Anda
✅ Menunggu respons
✅ Menyimpan token dan ID pengguna di lingkungan
✅ Membuat semua pengujian di masa depan berjalan otomatis, tanpa setup manual

Mengapa Ini Penting? Pengujian Menjadi Efisien, Andal, dan Dapat Diskalakan

Dengan pre-script, Anda akan melihat beberapa hasil yang luar biasa:

• Tidak ada lagi setup berulang di setiap pengujian.
• Eksekusi pengujian lebih cepat, karena setup telah diotomatisasi.
• Kurang ruang untuk kesalahan, karena prosesnya diotomatisasi dan konsisten.
• Dapat diskalakan, yang berarti Anda dapat mengembangkan pengujian hingga ribuan permintaan tanpa kesulitan.

Sekarang, baik Anda memiliki 5, 50, atau 500 pengujian untuk dijalankan — fondasi Anda kuat.

Mengapa EchoAPI Membuat Pre-Script Lebih Baik

Di EchoAPI, kami telah membuat pre-script menjadi sederhana, intuitif, dan mudah diintegrasikan. Tidak hanya Anda dapat menulis pre-script untuk mengotomatisasi autentikasi, menyetel variabel global, dan mengonfigurasi lingkungan, tetapi Anda juga mendapatkan:

• Debugging waktu nyata sehingga Anda dapat menangkap kesalahan segera.
• Sinkronisasi variabel global, memastikan semua pengujian Anda menggunakan data dan lingkungan yang sama.
• Pengaturan pre-script fleksibel, baik Anda membutuhkannya untuk seluruh koleksi atau hanya permintaan tertentu.

Siap Mencoba EchoAPI? Gratis, Cepat, dan Mudah!

Jangan biarkan pengujian API Anda menjadi tumpukan LEGO yang kacau. Atur dengan baik, automatisasi setup, dan saksikan pengujian Anda berjalan lebih顺畅 dari sebelumnya.

Coba EchoAPI sekarang dan lihat bagaimana pre-script dapat menghemat waktu Anda, mengurangi kesalahan, dan membuat pengujian Anda lebih andal. Hanya membutuhkan beberapa menit untuk setup, dan hasilnya akan membuat Anda terkesan!

Kesimpulan: Pre-Script Adalah Senjata Rahasia Anda

Sama seperti Anda tidak akan membangun kota LEGO tanpa rencana, Anda juga tidak boleh menguji API tanpa pre-script.
Ini adalah gambar kerja untuk lingkungan pengujian Anda — dan memastikan setiap pengujian disiapkan dengan baik, konsisten, dan otomatis.