Ana içeriğe geç

http in Düğümü

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şim için bir giriş noktasıdır.

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

http in Düğüm 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ısmi olarak güncellemek için kullanılır.
  • OPTIONS: API hakkında meta bilgi almak için isteklerde kullanılır.

3. Bağlantı​

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

  • Yol / ile başlar.
  • Örneğin: /data/:id gibi rota değişkenlerini içerebilir.

Örnek:

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

4. Koruma​

Uç noktanın koruma bayrağı. Varsayılan olarak açıktır.

5. Çıktı Örneği (JSON)​

Düğümün akışta daha ileriye ilettiği verilerin JSON formatındaki örneği.
Bu örnek, bir sonraki düğüm için veri şemasını oluşturur — alanları, bir sonraki düğümün Girdi Şeması bloğunda görünür. Alan boşsa veya içindeki JSON geçersizse, şema daha ileriye iletilmez.

Giriş Mesajı Formatı​

Belirtilen yola seçilen yöntemle bir istek geldiğinde, 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 isteği 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.

Kullanım Örneği​

Örnek 1: GET isteğinin işlenmesi​

Senaryo: Sıcaklık verilerinin döndürülmesi.

Düğüm Ayarları:

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

Akış:

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

function düğüm kodu:

msg.payload = { sıcaklık: 22.5, birim: "Celsius" };
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": "Celsius"
}

Örnek 2: POST isteğinin işlenmesi​

Senaryo: Cihazdan veri alma ve kaydetme.

Düğüm Ayarları:

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

Akış:

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

function düğüm kodu:

// İsteğin gövdesinden verileri 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 verileri alacak ve onay ile yanıt verecektir.

Örnek 3: Rota parametrelerinin kullanımı​

Senaryo: Cihaz kimliğine göre veri alma.

Düğüm Ayarları:

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

Akış:

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

function düğüm kodu:

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

Sonuç:

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