Keajaiban Nilai Dinamis & Fungsi Kustom di EchoAPI

Nilai dinamis dan fungsi kustom adalah dua senjata andalan di EchoAPI yang membuat pengujian API jauh lebih cepat, fleksibel, dan siap menangani logika bisnis yang rumit. Fitur-fitur ini sangat berguna saat kita harus menjalankan alur multi-langkah, mengatasi ketergantungan antar-parameter, atau beradaptasi dengan skenario tak terduga. Mari kita bahas satu per satu dengan studi kasus nyata.

1. Nilai Dinamis: Parameter yang Selalu Sesuai Konteks

Nilai dinamis adalah parameter yang dibuat atau diambil secara otomatis saat runtime—mulai dari cap waktu, angka acak, hingga data dari respons sebelumnya. Fitur ini menyelesaikan dua masalah besar: parameter yang selalu berubah dan ketergantungan antar-API.

Studi Kasus: Alur Checkout E-commerce (Lintas API)

Seorang developer di Amerika sedang men-debug rantai Buat Pesanan → Bayar Pesanan:

1. API Buat Pesanan mengembalikan orderId unik setiap kali dipanggil.

Simpan orderId ke variabel lingkungan

Tambahkan Post-response → Extract Variables

Kirim permintaan → lihat hasil acak

Pilih fungsi → Insert

Klik Mock data function

2. API Pembayaran membutuhkan:

• orderId dari langkah sebelumnya
• timestamp untuk mencegah permintaan kadaluarsa
• nonce untuk menghindari serangan replay

Cara Menggunakan Nilai Dinamis

1. Setelah memanggil Buat Pesanan, gunakan Post-response → Extract Variables untuk menyimpan orderId ke lingkungan.
2. Saat memanggil API Pembayaran, pilih nilai dinamis untuk parameter:
   • orderId: Reference Env → orderId
   • timestamp: Add Dynamic Value → Mock Data → Date (ms otomatis)
   • nonce: Add Dynamic Value → Mock Data → Random String (format valid otomatis)

Manfaat Utama

• Bebas salah ketik: Tidak perlu salin-tempel ID atau hitung cap waktu secara manual.
• Debug lebih cepat: Alur multi-API yang biasanya 5 menit kini cukup 1 menit.
• Siap lintas zona waktu: Otomatis membuat UTC, JST, PST, WIB, dll., tanpa konversi manual.

2. Nilai Dinamis Bawaan Sistem

EchoAPI menyediakan nilai dinamis siap pakai tanpa konfigurasi tambahan. Data dihasilkan secara real-time sesuai kebutuhan pengujian.

Nilai Berbasis Waktu

Kelebihan: Tidak perlu pusing menghitung zona waktu—tinggal pakai.

Nilai Acak

Informasi Lingkungan

Konstanta & Format

Contoh komposisi:

ORDER_{{$fakerjs.Date.birthdate|format(YYYY/MM/DD HH:mm:ss,+08:00)}}{{$fakerjs.String.uuid}}

3. Fungsi Kustom: Solusi untuk Logika Bisnis Spesifik

Fungsi kustom memungkinkan kita menulis skrip (JavaScript, dll.) untuk kebutuhan khusus seperti enkripsi, validasi, atau format non-standar.

Studi Kasus: Enkripsi Parameter Fintech

Developer fintech di Indonesia sedang debug API Bind Card dengan aturan:

1. Parameter sensitif (mis. phone) harus dienkripsi MD5 (bukan standar umum).

2. Hasil enkripsi diberi prefix IDN_FIN_.

Cara Menggunakan Fungsi Kustom

1. Di modul Custom Function, buat skrip:

try {
    let hash = 0;
    if (text.length === 0) return hash.toString(16);
    for (let i = 0; i < text.length; i++) {
        let char = text.charCodeAt(i);
        hash = ((hash << 5) - hash) + char;
        hash = hash & hash;
    }
    return "IDN_FIN_" + hash.toString(16);
} catch (e) {
    return text;
}

Referensikan fungsi di parameter

Masukkan skrip dan uji hasilnya

Klik Create

Pilih Custom Function Management

Klik Functions

2. Saat memanggil API Bind Card, pilih Custom Function → MD5Encrypt → masukkan nilai mentah → EchoAPI otomatis enkripsi dan tambahkan prefix.

4. Fungsi Sistem Bawaan EchoAPI

EchoAPI juga menyediakan fungsi bawaan tanpa kode—langsung pakai untuk transformasi string, konversi data, enkripsi, bahkan operasi matematika.

1. Fungsi String

Contoh praktis: Normalisasi ID produk di toko daring AS—jadikan huruf besar dan tambahkan nol di depan.

2. Fungsi Konversi Data

Adaptasi regional:

• Jepang → "YYYY年MM月DD日"
• Indonesia → "DD/MM/YYYY"

3. Fungsi Enkripsi & Encoding

Studi kasus: Tambahkan HMAC-SHA256 pada parameter API fintech Indonesia untuk keamanan transmisi.

4. Fungsi Matematika & Logika

Contoh e-commerce AS: Hitung pajak penjualan (amount × taxRate), lalu pembulatan dua desimal.

5. Fungsi Utilitas Sistem

Contoh praktis: Set token otomatis sebelum request, atau tambahkan log debug di alur kompleks.

6. Fitur Unggulan Fungsi Sistem

• Tanpa Konfigurasi: Langsung pakai.
• Konsisten Lintas Platform: EchoAPI desktop, VS Code, IntelliJ sama saja.

• Komposabel: Bisa disusun menjadi logika kompleks.
• Offline: Semua dieksekusi lokal tanpa internet.
• Regional: Format tanggal otomatis menyesuaikan lokal.

Ringkasan: Nilai Tambah Utama

Dengan memanfaatkan kedua fitur ini, tim dapat fokus pada validasi bisnis, bukan lagi pada pengaturan parameter. Alur kerja jadi lebih cepat, lebih sedikit kesalahan manusia, dan integrasi lintas region pun berjalan mulus.