DEV Community

Cover image for Cara Menggunakan Talend API Tester untuk Pengujian API
Walse
Walse

Posted on • Originally published at apidog.com

Cara Menggunakan Talend API Tester untuk Pengujian API

Talend API Tester adalah ekstensi Chrome untuk mengirim permintaan HTTP dan memeriksa respons langsung dari peramban. Alat ini sebelumnya dikenal sebagai Restlet Client, mendukung API REST, metode HTTP umum, pengelompokan request, skenario multi-langkah, dan assertions untuk memvalidasi respons secara otomatis.

Coba Apidog hari ini

Panduan ini menunjukkan cara memakai Talend API Tester untuk pengujian API praktis: instal ekstensi, kirim request pertama, susun request ke dalam proyek dan layanan, buat skenario berurutan, lalu tambahkan assertions agar validasi respons tidak dilakukan manual.

Instal ekstensi dan kirim request pertama

Talend API Tester tersedia di Chrome Web Store. Cari “Talend API Tester”, lalu klik Tambahkan ke Chrome. Ekstensi ini juga dapat berjalan di browser berbasis Chromium seperti Edge dan Brave.

Setelah terinstal:

  1. Buka Talend API Tester dari menu ekstensi Chrome.
  2. Sematkan ke toolbar jika ingin akses cepat.
  3. Buka panel request.
  4. Pilih metode HTTP.
  5. Masukkan URL endpoint.
  6. Klik Send.

Contoh request GET menggunakan JSONPlaceholder:

GET https://jsonplaceholder.typicode.com/users/1
Enter fullscreen mode Exit fullscreen mode

Setelah dikirim, Talend API Tester menampilkan:

  • status code
  • response time
  • response headers
  • response body
  • format JSON/XML yang sudah dirapikan

Untuk mencoba POST, ubah metode menjadi POST, buka tab Body, pilih application/json, lalu masukkan payload:

{
  "name": "Priya Nair",
  "email": "priya.nair@example.com"
}
Enter fullscreen mode Exit fullscreen mode

Jika API membutuhkan autentikasi, tambahkan header di tab Headers:

Authorization: Bearer <token-anda>
Enter fullscreen mode Exit fullscreen mode

Talend API Tester juga menyediakan helper autentikasi untuk skema Basic, Digest, OAuth, dan Bearer jika Anda tidak ingin menulis header secara manual.

Atur request ke dalam proyek dan layanan

Untuk percobaan cepat, request lepas masih cukup. Namun saat jumlah endpoint bertambah, Anda perlu struktur.

Talend API Tester menggunakan dua level utama:

  • Project: wadah utama untuk satu API atau satu domain kerja.
  • Service: pengelompokan endpoint terkait di dalam project.

Contoh struktur:

Project: API Pengguna
├── Service: Pengguna
│   ├── GET /users
│   ├── GET /users/{id}
│   ├── POST /users
│   └── DELETE /users/{id}
└── Service: Pesanan
    ├── GET /orders
    └── POST /orders
Enter fullscreen mode Exit fullscreen mode

Langkah praktis:

  1. Buat project baru dari sidebar.
  2. Beri nama yang jelas, misalnya API Pengguna.
  3. Buat service berdasarkan domain endpoint, misalnya Pengguna dan Pesanan.
  4. Simpan setiap request ke service yang sesuai.
  5. Jika tersedia, gunakan base URL pada service agar setiap request cukup memakai path.

Contoh:

Base URL:
https://api.example.com

Request path:
GET /users/1
Enter fullscreen mode Exit fullscreen mode

Dengan cara ini, request lebih mudah dicari dan dapat dipakai ulang dalam skenario.

Talend API Tester juga mendukung variabel lingkungan. Misalnya, Anda dapat membuat variabel host:

host = https://staging.example.com
Enter fullscreen mode Exit fullscreen mode

Lalu gunakan di request:

GET {{host}}/users/1
Enter fullscreen mode Exit fullscreen mode

Buat environment lain untuk production:

host = https://api.example.com
Enter fullscreen mode Exit fullscreen mode

Dengan switching environment, seluruh project dapat diarahkan ke target berbeda tanpa mengedit URL satu per satu. Ini membantu menghindari kesalahan seperti menjalankan request destruktif ke server produksi.

Talend API Tester juga dapat mengimpor pekerjaan yang sudah ada, termasuk:

  • koleksi Postman
  • definisi Swagger
  • definisi OpenAPI
  • file HAR

Jika Anda sudah memiliki spesifikasi API atau ekspor Postman, impor file tersebut daripada membuat ulang request manual. Untuk menyusun pemeriksaan API secara lebih sistematis, lihat panduan contoh kasus uji API.

Bangun skenario untuk menjalankan request berurutan

Satu request hanya menguji satu panggilan. Pengujian API nyata biasanya berbentuk alur:

  1. login
  2. buat data
  3. baca data
  4. ubah data
  5. hapus data

Di Talend API Tester, alur seperti ini dibuat dengan scenario.

Scenario adalah daftar request tersimpan yang dijalankan secara berurutan. Cara membuatnya:

  1. Simpan request yang ingin digunakan.
  2. Buat scenario baru dari sidebar.
  3. Tambahkan request ke scenario sesuai urutan eksekusi.
  4. Jalankan scenario.
  5. Periksa hasil setiap langkah.

Contoh alur CRUD:

1. POST /users
2. GET /users/{id}
3. PUT /users/{id}
4. DELETE /users/{id}
Enter fullscreen mode Exit fullscreen mode

Bagian penting dari scenario adalah meneruskan data antar-langkah. Misalnya, request POST /users mengembalikan id:

{
  "id": 123,
  "name": "Priya Nair"
}
Enter fullscreen mode Exit fullscreen mode

Nilai id tersebut dapat diekstrak ke variabel, lalu dipakai pada request berikutnya:

GET /users/{{userId}}
Enter fullscreen mode Exit fullscreen mode

Pola ini membuat scenario dapat menguji stateful flow, bukan hanya request terisolasi.

Talend API Tester juga mendukung logika kondisional dan pengulangan. Dengan kombinasi ekstraksi variabel, conditional step, dan loop, Anda dapat membuat scenario yang lebih realistis, misalnya:

1. Authenticate
2. Extract access token
3. Create record
4. Extract record ID
5. Verify record can be read
6. Update record
7. Delete record
Enter fullscreen mode Exit fullscreen mode

Menjalankan alur seperti ini dari awal sampai akhir memberi sinyal regresi yang lebih baik dibanding menjalankan request satu per satu. Untuk memahami perbedaannya, baca artikel tentang skenario uji versus kasus uji.

Tambahkan assertions agar respons divalidasi otomatis

Menjalankan request hanya menunjukkan respons. Assertions membuat tool mengecek apakah respons tersebut benar.

Di Talend API Tester, assertions ditambahkan ke request tersimpan melalui form, bukan dengan menulis script. Assertion umum meliputi:

  • Status code sama dengan nilai yang diharapkan, misalnya 200 atau 201.
  • Response time di bawah ambang tertentu, misalnya 500ms.
  • Field payload cocok dengan nilai yang diharapkan.
  • Header ada atau memiliki nilai tertentu.

Contoh validasi sederhana untuk endpoint GET /users/1:

Status code = 200
Response time < 500ms
Body field $.id = 1
Header Content-Type contains application/json
Enter fullscreen mode Exit fullscreen mode

Saat request dijalankan, Talend API Tester mengevaluasi setiap assertion dan menandai hasilnya sebagai pass atau fail.

Dalam scenario, assertion berguna untuk mengubah alur menjadi pemeriksaan regresi:

Step 1: POST /users
- Assert status code = 201
- Extract id

Step 2: GET /users/{{id}}
- Assert status code = 200
- Assert body.id = {{id}}

Step 3: DELETE /users/{{id}}
- Assert status code = 200 or 204
Enter fullscreen mode Exit fullscreen mode

Karena assertions berbasis form, Talend API Tester mudah digunakan oleh tester yang tidak menulis JavaScript. Namun, bentuk assertion-nya lebih terbatas dibanding tool berbasis script. Jika Anda perlu validasi kompleks seperti perhitungan dinamis atau kondisi lintas-field, Anda mungkin akan mencapai batasnya.

Untuk pemeriksaan harian, kombinasi status code, response time, header, dan beberapa field body biasanya cukup. Untuk referensi lebih mendalam, lihat panduan tentang pernyataan API.

Baca respons dengan benar

Baik memakai assertions atau tidak, Anda tetap perlu memahami respons API. Fokus pada empat bagian berikut.

1. Status code

Status code adalah sinyal pertama.

2xx = sukses
4xx = request bermasalah
5xx = server bermasalah
Enter fullscreen mode Exit fullscreen mode

Contoh:

200 OK
201 Created
400 Bad Request
401 Unauthorized
404 Not Found
500 Internal Server Error
Enter fullscreen mode Exit fullscreen mode

Untuk interpretasi yang lebih tepat, lihat panduan kode status HTTP yang harus digunakan oleh API REST.

2. Response time

Talend API Tester menampilkan durasi request. Endpoint yang lambat tetap bermasalah meskipun body respons benar.

Contoh assertion praktis:

Response time < 500ms
Enter fullscreen mode Exit fullscreen mode

3. Headers

Headers sering menjelaskan perilaku yang tidak terlihat dari body, misalnya:

Content-Type: application/json
Cache-Control: no-cache
Access-Control-Allow-Origin: *
X-RateLimit-Remaining: 99
Enter fullscreen mode Exit fullscreen mode

Periksa headers saat Anda men-debug masalah format, caching, rate limit, atau CORS.

4. Body

Body berisi data aktual, biasanya JSON atau XML. Validasi:

  • field yang wajib ada
  • tipe data
  • nilai yang diharapkan
  • struktur nested object
  • array length jika relevan

Contoh body:

{
  "id": 1,
  "name": "Leanne Graham",
  "email": "Sincere@april.biz"
}
Enter fullscreen mode Exit fullscreen mode

Contoh pemeriksaan:

$.id = 1
$.email exists
$.name is not empty
Enter fullscreen mode Exit fullscreen mode

Membaca status code, response time, headers, dan body secara bersamaan memberi gambaran yang lebih akurat tentang kesehatan API.

Ketika ekstensi Chrome tidak cukup

Talend API Tester cepat dan nyaman untuk pemeriksaan API langsung dari browser. Namun, batasannya mulai terlihat saat kebutuhan pengujian berkembang:

  • berjalan sebagai ekstensi Chrome
  • tidak dirancang untuk eksekusi headless di pipeline CI
  • assertions cukup solid tetapi tetap dasar
  • tidak mencakup desain API, mocking, dan dokumentasi dalam satu workspace

Apidog adalah platform API all-in-one yang dapat mengisi celah tersebut. Apidog adalah aplikasi mandiri, dapat mengimpor Postman, OpenAPI, dan format lain, serta menyediakan visual assertion builder, mock server, skenario pengujian otomatis, dan dokumentasi yang dihasilkan dalam satu project.

Karena spesifikasi dan pengujian berbagi satu sumber kebenaran, keduanya lebih mudah dijaga tetap sinkron. Anda dapat mengunduh Apidog dan mengimpor request yang sudah ada untuk membandingkan workflow. Untuk melihat opsi lain, baca perbandingan alat pengujian API online gratis.

Talend API Tester tetap cocok untuk pemeriksaan cepat di browser. Gunakan sesuai skala pekerjaan: ekstensi untuk validasi cepat, platform API penuh untuk workflow tim, dokumentasi, mocking, dan otomasi yang lebih besar.

Pertanyaan yang sering diajukan

Apakah Talend API Tester sama dengan Restlet Client?

Ya. Talend API Tester adalah versi yang diganti namanya dari alat yang dulu disebut Restlet Client. Fungsionalitas utamanya tetap sama: ekstensi Chrome untuk mengirim request HTTP, mengelolanya, menjalankan scenario, dan menambahkan assertions.

Apakah Talend API Tester gratis?

Ada versi gratis di Chrome Web Store yang mencakup pengiriman request, pengorganisasian ke dalam project, serta pembuatan scenario dengan assertions. Tingkatan berbayar secara historis menambahkan fitur tim dan batas yang lebih besar. Untuk sebagian besar pengujian individu, versi gratis sudah cukup.

Bisakah Talend API Tester menjalankan pengujian di CI/CD?

Tidak secara langsung. Karena berjalan sebagai ekstensi Chrome di dalam browser, Talend API Tester tidak dirancang untuk eksekusi headless di pipeline CI/CD. Untuk pengujian otomatis di setiap commit, gunakan tool yang menyediakan command line runner. Panduan tentang mengotomatiskan pengujian API di CI/CD menjelaskan pola setup tersebut.

Format apa saja yang dapat diimpor oleh Talend API Tester?

Talend API Tester dapat mengimpor:

  • koleksi Postman
  • definisi Swagger
  • definisi OpenAPI
  • file HAR

Ini berguna jika Anda sudah memiliki spesifikasi API atau hasil ekspor dari tool lain.

Bagaimana scenario berbeda dari satu request?

Satu request mengirim satu panggilan HTTP dan menampilkan satu respons. Scenario adalah daftar request berurutan yang dijalankan dari atas ke bawah. Scenario juga dapat meneruskan data dari satu respons ke request berikutnya, misalnya memakai id dari hasil create untuk request get, update, atau delete berikutnya.

Top comments (0)