Talend API Tester adalah ekstensi Chrome untuk mengirim permintaan HTTP dan memeriksa respons tanpa meninggalkan peramban Anda. Sebelumnya dikenal sebagai Restlet Client, dan banyak pengembang masih menginstalnya untuk pemeriksaan cepat karena tidak ada yang perlu diunduh selain ekstensi itu sendiri. Ini menangani API REST, mendukung metode HTTP umum, dan dapat merangkai permintaan menjadi skenario.
Panduan ini menunjukkan cara menggunakan Talend API Tester untuk pekerjaan pengujian nyata. Anda akan menginstalnya, mengirim permintaan pertama Anda, mengatur permintaan ke dalam proyek dan layanan, membangun skenario yang menjalankan beberapa permintaan secara berurutan, dan menambahkan pernyataan (assertions) sehingga alat ini memeriksa respons untuk Anda alih-alih Anda memeriksanya secara manual. Contoh-contoh menggunakan API publik sehingga Anda dapat langsung mengikutinya.
Instal ekstensi dan kirim permintaan
Talend API Tester tersedia di Chrome Web Store. Cari “Talend API Tester” dan klik Tambahkan ke Chrome. Ini juga berjalan di peramban berbasis Chromium seperti Edge dan Brave. Setelah terinstal, buka dari menu ekstensi atau sematkan ke bilah alat untuk akses cepat.
Antarmuka memiliki bilah sisi di sebelah kiri dan panel permintaan di sebelah kanan. Klik ke panel permintaan dan Anda akan melihat dropdown metode, bidang URL, dan tab untuk header dan body.
Untuk mengirim permintaan dasar, pilih GET dan masukkan titik akhir yang sebenarnya. Layanan JSONPlaceholder bekerja dengan baik untuk latihan:
GET https://jsonplaceholder.typicode.com/users/1
Klik Kirim. Respons muncul di bawah dengan kode status, waktu respons, header, dan body. Talend API Tester mencetak JSON dan XML dengan rapi, sehingga respons bersarang dapat dibaca tanpa langkah tambahan.
Untuk POST, ubah metode, buka bagian Body, dan pilih jenis konten. Pilih application/json dan masukkan payload:
{
"name": "Priya Nair",
"email": "priya.nair@example.com"
}
Tambahkan header di bawah bagian Headers. Untuk API terautentikasi, tambahkan header Authorization dengan token Anda. Alat ini juga memiliki pembantu autentikasi bawaan untuk skema Basic, Digest, OAuth, dan Bearer jika Anda lebih suka tidak mengatur header secara manual.
Atur permintaan ke dalam proyek dan layanan
Beberapa permintaan lepas baik-baik saja untuk pemeriksaan cepat pada API. Setelah Anda memiliki banyak, Anda ingin struktur. Talend API Tester mengatur pekerjaan ke dalam proyek, dan di dalam proyek ke dalam layanan.
Buat proyek dari bilah sisi dan berikan nama yang jelas seperti “API Pengguna.” Di dalamnya, buat layanan yang mengelompokkan titik akhir terkait, misalnya layanan “Pengguna” dan layanan “Pesanan”. Simpan setiap permintaan ke layanan yang tepat. Sebuah layanan dapat menyimpan URL dasar, sehingga permintaan individual di bawahnya hanya membutuhkan path, yang menjaga semuanya tetap rapi.
Struktur ini penting karena dua alasan. Pertama, ini membuat kumpulan permintaan yang besar dapat dinavigasi, sehingga Anda tidak perlu menggulir puluhan panggilan tanpa label untuk menemukan yang Anda inginkan. Kedua, ini adalah dasar untuk skenario, yang akan kita bahas selanjutnya, karena skenario mereferensikan permintaan yang disimpan.
Proyek juga membantu dalam penggantian lingkungan. Talend API Tester mendukung variabel lingkungan, sehingga Anda dapat mendefinisikan variabel host yang menyimpan URL staging Anda dan mereferensikannya di setiap permintaan dalam sebuah proyek dengan placeholder. Definisikan lingkungan kedua dengan host produksi, beralih di antara keduanya, dan seluruh proyek akan segera menargetkan ulang. Ini mencegah Anda mengedit URL secara manual dan secara tidak sengaja menembakkan permintaan destruktif ke server yang salah.
Talend API Tester juga dapat mengimpor pekerjaan yang sudah ada. Ini menerima koleksi Postman, definisi Swagger dan OpenAPI, serta file HAR. Jika Anda sudah memiliki spesifikasi API atau ekspor Postman, impor saja daripada membuat ulang setiap permintaan secara manual. Untuk cara terstruktur dalam memikirkan pengelompokan pemeriksaan, panduan contoh kasus uji API adalah teman yang berguna.
Bangun skenario untuk menjalankan permintaan secara berurutan
Satu permintaan menjawab satu pertanyaan. Pengujian nyata biasanya berarti alur: membuat catatan, membacanya kembali, memperbaruinya, menghapusnya. Talend API Tester menangani ini dengan skenario.
Skenario adalah daftar permintaan yang disimpan yang berurutan. Buat satu dari bilah sisi, lalu tambahkan permintaan ke dalamnya sesuai urutan mereka harus dijalankan. Saat Anda menjalankan skenario, alat ini akan menembakkan setiap permintaan dari atas ke bawah dan menunjukkan hasil setiap langkah.
Bagian yang berguna adalah meneruskan data antar langkah. Sebuah skenario dapat menangkap nilai dari satu respons dan memasukkannya ke permintaan selanjutnya. Misalnya, permintaan "buat pengguna" mengembalikan id baru di tubuh responsnya. Anda mengekstrak id itu ke dalam variabel, lalu permintaan "dapatkan pengguna" selanjutnya menggunakan variabel tersebut di URL-nya. Ini adalah cara Anda menguji alur yang memiliki keadaan daripada panggilan yang terisolasi.
Skenario juga mendukung logika kondisional dan pengulangan. Anda dapat bercabang berdasarkan respons, sehingga suatu langkah hanya berjalan jika yang sebelumnya mengembalikan status tertentu, dan Anda dapat mengulang suatu langkah untuk memukul titik akhir berulang kali. Dikombinasikan dengan ekstraksi variabel, ini memungkinkan satu skenario memodelkan urutan yang realistis: autentikasi, buat catatan, konfirmasikan bahwa itu terbaca kembali dengan benar, modifikasi, lalu bersihkan dengan menghapusnya. Menjalankan skenario itu dari awal hingga akhir adalah sinyal yang jauh lebih baik daripada menembakkan setiap permintaan secara terpisah. Artikel tentang skenario uji versus kasus uji menjelaskan perbedaan antara satu pemeriksaan dan alur multi-langkah, yang memetakan langsung ke permintaan versus skenario di sini.
Tambahkan pernyataan (assertions) sehingga alat memeriksa respons
Menjalankan skenario menunjukkan kepada Anda apa yang kembali. Pernyataan (Assertions) membuat alat memutuskan apakah yang kembali itu benar, sehingga Anda tidak perlu membaca setiap respons secara manual.
Talend API Tester memungkinkan Anda melampirkan pernyataan ke permintaan. Buka permintaan yang disimpan dan temukan bagian pernyataan. Anda membuat pernyataan melalui formulir daripada menulis kode. Yang umum meliputi:
- Kode status sama dengan nilai yang diharapkan, seperti
200atau201. - Waktu respons di bawah ambang batas, seperti
500milidetik. - Bidang payload cocok dengan nilai yang diharapkan, menggunakan jalur ke body JSON.
- Header ada atau memiliki nilai tertentu.
Setiap pernyataan yang Anda tambahkan akan dievaluasi saat permintaan berjalan, baik sendiri maupun sebagai langkah dalam skenario. Panel hasil menandai setiap pernyataan yang berhasil atau gagal. Jalankan seluruh skenario dan Anda akan mendapatkan hasil lulus atau gagal yang jelas di setiap langkah, yang mengubah skenario menjadi pemeriksaan regresi yang dapat diulang.
Karena pernyataan berbasis formulir daripada kode, alat ini mudah diakses oleh penguji yang tidak menulis JavaScript. Itu adalah kekuatan nyata untuk verifikasi manual yang cepat. Sisi sebaliknya adalah bahwa kosakata pernyataan lebih sempit daripada alat berbasis skrip. Jika Anda perlu membuat pernyataan tentang sesuatu yang tidak dapat diekspresikan oleh formulir, seperti nilai yang dihitung atau kondisi kompleks di beberapa bidang, Anda akan mencapai batasnya. Untuk sebagian besar pemeriksaan sehari-hari, kode status ditambah beberapa pernyataan bidang body sudah cukup. Untuk panduan tentang apa yang layak untuk ditegaskan, lihat panduan yang lebih mendalam tentang pernyataan API.
Baca respons dengan benar
Terlepas dari apakah Anda menambahkan pernyataan atau tidak, Anda harus tahu cara membaca respons. Ada empat bagian yang penting.
- Kode status. Ini adalah sinyal pertama.
2xxberarti sukses,4xxberarti permintaan salah,5xxberarti server gagal. Referensi seperti panduan tentang kode status HTTP yang harus digunakan oleh API REST membantu Anda menafsirkan yang kurang jelas. - Waktu respons. Talend API Tester melaporkan berapa lama permintaan berlangsung. Titik akhir yang lambat adalah masalah bahkan ketika mengembalikan data yang benar.
- Header. Header membawa
Content-Type, direktif caching, informasi batas kecepatan, dan detail CORS. Mereka sering menjelaskan perilaku yang tidak dijelaskan oleh body. - Body. Data aktual, biasanya JSON atau XML. Periksa apakah bidang, tipe, dan nilai sesuai dengan kontrak yang dijanjikan.
Membaca keempatnya bersama-sama memberi tahu Anda apakah API sehat, bukan hanya apakah ia merespons.
Ketika ekstensi Chrome tidak cukup
Talend API Tester nyaman dan cepat untuk pemeriksaan berbasis peramban. Batasannya muncul seiring dengan berkembangnya pekerjaan. Ini terikat pada Chrome, jadi tidak dapat berjalan tanpa antarmuka grafis (headless) dalam pipeline CI. Sistem pernyataannya solid tetapi dasar dibandingkan dengan platform pengujian lengkap. Dan itu tidak mencakup desain API, mocking, atau dokumentasi, jadi ini adalah salah satu alat di antara beberapa daripada satu ruang kerja.
Apidog adalah platform API all-in-one yang mengisi celah-celah tersebut. Ini adalah aplikasi mandiri daripada ekstensi peramban, ia mengimpor Postman, OpenAPI, dan format lain seperti yang dilakukan Talend API Tester, dan menambahkan pembuat pernyataan visual, server mock, skenario uji otomatis, dan dokumentasi yang dihasilkan dalam satu proyek. Karena spesifikasi dan pengujian berbagi satu sumber kebenaran, keduanya tidak menyimpang. Anda dapat mengunduh Apidog dan mengimpor permintaan Anda yang sudah ada untuk membandingkan. Untuk survei opsi yang lebih luas, perbandingan alat pengujian API online gratis adalah titik awal yang baik.
Talend API Tester tetap menjadi pilihan yang baik untuk pemeriksaan cepat di dalam peramban. Sesuaikan alat dengan ukuran dan tahap pekerjaan pengujian Anda.
Pertanyaan yang sering diajukan
Apakah Talend API Tester sama dengan Restlet Client?
Ya. Talend API Tester adalah versi yang diubah namanya dari alat yang dulu disebut Restlet Client. Fungsionalitasnya memiliki garis keturunan yang sama: ekstensi Chrome untuk mengirim permintaan HTTP, mengaturnya, dan menjalankan skenario dengan pernyataan.
Apakah Talend API Tester gratis?
Ada versi gratis yang tersedia di Chrome Web Store yang mencakup pengiriman permintaan, pengorganisasiannya ke dalam proyek, dan pembangunan skenario dengan pernyataan. Tingkatan berbayar secara historis menambahkan fitur tim dan batas yang lebih besar. Versi gratis cukup untuk sebagian besar pekerjaan pengujian individu.
Bisakah Talend API Tester menjalankan pengujian di CI/CD?
Tidak secara langsung. Ini adalah ekstensi Chrome dan berjalan di dalam peramban, sehingga tidak dapat dieksekusi tanpa antarmuka grafis (headless) dalam pipeline. Untuk pengujian otomatis yang berjalan di setiap commit, Anda memerlukan alat dengan command line runner. Panduan tentang mengotomatiskan pengujian API di CI/CD membahas seperti apa penyiapan tersebut.
Format apa saja yang dapat diimpor oleh Talend API Tester?
Ini dapat mengimpor koleksi Postman, definisi Swagger dan OpenAPI, dan file HAR. Ini memungkinkan Anda membawa spesifikasi API atau ekspor yang sudah ada daripada membuat ulang setiap permintaan secara manual.
Bagaimana skenario berbeda dari satu permintaan?
Satu permintaan mengirim satu panggilan HTTP dan menunjukkan satu respons. Skenario adalah daftar permintaan berurutan yang berjalan secara berurutan, dan dapat meneruskan data yang diambil dari satu respons ke permintaan selanjutnya. Skenario menguji alur multi-langkah, seperti membuat lalu membaca lalu menghapus, sementara satu permintaan menguji satu panggilan terisolasi.