Ana içeriğe geç

Node http in

http in düğümü, gelen HTTP isteklerini (GET, POST, PUT ve diğerleri) işleyebilen HTTP uç noktaları oluşturmak için kullanılır. Bu düğüm, HTTP protokolü aracılığıyla dış sistemlerle etkileşimde bulunmak için giriş noktası olarak hizmet eder.

Önemli: Tüm belirtilen yollar otomatik olarak şu ön eki alır: /api/admin/workflows/endpoints/.

http in düğümü için ayarlar​

IMG2

1. İsim​

Düğümün adını belirtmek için bir alan.
İsim, çalışma alanında görüntülenir ve düğümü kolayca tanımlamaya yardımcı olur.
Boş bırakılırsa, düğüm http in olarak adlandırılacaktır.

Örnek:

  • Düğüm adı: ödeme bağlantısını al

2. Yöntem​

Düğümün işleyeceği HTTP yöntemi. Aşağıdaki seçenekler mevcuttur:

  • GET: Veri almak için kullanılır.
  • POST: Veri göndermek için kullanılır.
  • PUT: Veriyi güncellemek için kullanılır.
  • DELETE: Veriyi silmek için kullanılır.
  • PATCH: Veriyi kısmen güncellemek için kullanılır.
  • OPTIONS: API hakkında meta verileri elde etmek için yapılan istekler için kullanılır.

3. Bağlantı​

İstekleri işlemek için yolu (uç noktayı) belirtir.

  • Yol / ile başlar.
  • Rota parametrelerini içerebilir, örneğin: /data/:id.

Örnek:

  • Bağlantı: /ödeme-bağlantısını-al
  • Parametreli bağlantı: /ödeme-bağlantısını-al/:siparişId

Gelen mesajın formatı​

Belirtilen yolda seçilen yöntemle bir istek alındığında, http in düğümü aşağıdaki özelliklere sahip bir msg mesajı oluşturur:

  • msg.req: Başlıklar, parametreler, gövde ve diğer veriler dahil olmak üzere HTTP istek nesnesini içerir.

    • msg.req.params: Rota parametreleri (örneğin, /api/data/:id içindeki :id).
    • msg.req.query: GET isteği parametreleri.
    • msg.req.body: İsteğin gövdesi (POST, PUT ve PATCH yöntemleri için).

  • msg.res: HTTP yanıtını yönetmek için bir nesne. Genellikle yanıtı istemciye göndermek için http response düğümüne iletilir.

Örnek kullanım​

Örnek 1: GET isteğini işleme​

Senaryo: Sıcaklık verilerini döndürme.

Düğüm ayarları:

  • Yöntem: GET
  • Bağlantı: /sıcaklık

Akış:

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

function düğümü için kod:

msg.payload = { sıcaklık: 22.5, birim: "Santigrat" };
return msg;

Sonuç: /api/admin/workflows/endpoints/sıcaklık adresine GET isteği gönderen istemci, aşağıdaki JSON yanıtını alacaktır:

{
  "sıcaklık": 22.5,
  "birim": "Santigrat"
}

Örnek 2: POST isteğini işleme​

Senaryo: Bir cihazdan veri alma ve kaydetme.

Düğüm ayarları:

  • Yöntem: POST
  • Bağlantı: /veri

Akış:

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

function düğümü için kod:

// İstek gövdesinden veri okuma
const veri = msg.req.body;
msg.payload = { durum: "başarılı", alınanVeri: veri };
return msg;

Sonuç: Düğüm, POST isteğinin gövdesinden veri alacak ve bir onay yanıtı döndürecektir.

Örnek 3: Rota parametrelerini kullanma​

Senaryo: Cihaz ID'sine göre veri alma.

Düğüm ayarları:

  • Yöntem: GET
  • Bağlantı: /cihaz/:id

Akış:

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

function düğümü için kod:

const cihazId = msg.req.params.id;
msg.payload = { cihazId: cihazId, durum: "aktif" };
return msg;

Sonuç:

{
  "cihazId": "123",
  "durum": "aktif"
}