Lewati ke konten utama

Node http in

Node http in digunakan untuk membuat endpoint HTTP yang dapat menangani permintaan HTTP yang masuk (GET, POST, PUT, dan lainnya). Node ini berfungsi sebagai titik masuk untuk berinteraksi dengan sistem eksternal melalui protokol HTTP.

Penting: Semua jalur yang ditentukan secara otomatis menerima awalan: /api/admin/workflows/endpoints/.

Pengaturan untuk node http in​

IMG2

1. Nama​

Sebuah kolom untuk menentukan nama node.
Nama ditampilkan di ruang kerja dan membantu mengidentifikasi node dengan mudah.
Jika dibiarkan kosong, node akan disebut http in.

Contoh:

  • Nama node: dapatkan tautan pembayaran

2. Metode​

Metode HTTP yang akan ditangani oleh node. Opsi berikut tersedia:

  • GET: Digunakan untuk mengambil data.
  • POST: Digunakan untuk mengirim data.
  • PUT: Digunakan untuk memperbarui data.
  • DELETE: Digunakan untuk menghapus data.
  • PATCH: Digunakan untuk memperbarui data secara parsial.
  • OPTIONS: Digunakan untuk permintaan untuk mendapatkan metadata tentang API.

3. Tautan​

Menentukan jalur (endpoint) untuk menangani permintaan.

  • Jalur dimulai dengan /.
  • Dapat mencakup parameter rute, misalnya: /data/:id.

Contoh:

  • Tautan: /get-payment-link
  • Tautan dengan parameter: /get-payment-link/:orderId

Format pesan yang masuk​

Ketika permintaan diterima di jalur yang ditentukan dengan metode yang dipilih, node http in membuat pesan msg dengan properti berikut:

  • msg.req: Berisi objek permintaan HTTP, termasuk header, parameter, body, dan data lainnya.

    • msg.req.params: Parameter rute (misalnya, :id di /api/data/:id).
    • msg.req.query: Parameter permintaan GET.
    • msg.req.body: Body dari permintaan (untuk metode POST, PUT, dan PATCH).

  • msg.res: Sebuah objek untuk mengelola respons HTTP. Biasanya diteruskan ke node http response untuk mengirim respons kembali ke klien.

Contoh penggunaan​

Contoh 1: Menangani permintaan GET​

Skenario: Mengembalikan data suhu.

Pengaturan node:

  • Metode: GET
  • Tautan: /temperature

Alur:

[http in] ---> [function] ---> [http response]

Kode untuk node function:

msg.payload = { temperature: 22.5, unit: "Celsius" };
return msg;

Hasil: Klien yang mengirim permintaan GET ke /api/admin/workflows/endpoints/temperature akan menerima respons JSON:

{
  "temperature": 22.5,
  "unit": "Celsius"
}

Contoh 2: Menangani permintaan POST​

Skenario: Menerima dan menyimpan data dari perangkat.

Pengaturan node:

  • Metode: POST
  • Tautan: /data

Alur:

[http in] ---> [function] ---> [http response]

Kode untuk node function:

// Membaca data dari body permintaan
const data = msg.req.body;
msg.payload = { status: "success", receivedData: data };
return msg;

Hasil: Node akan menerima data dari body permintaan POST dan mengembalikan respons konfirmasi.

Contoh 3: Menggunakan parameter rute​

Skenario: Mengambil data berdasarkan ID perangkat.

Pengaturan node:

  • Metode: GET
  • Tautan: /device/:id

Alur:

[http in] ---> [function] ---> [http response]

Kode untuk node function:

const deviceId = msg.req.params.id;
msg.payload = { deviceId: deviceId, status: "active" };
return msg;

Hasil:

{
  "deviceId": "123",
  "status": "active"
}