דלג לתוכן הראשי

צומת http in

צומת http in משמש ליצירת נקודות קצה HTTP שיכולות לעבד בקשות HTTP נכנסות (GET, POST, PUT ואחרות). צומת זה הוא נקודת הכניסה לאינטראקציה עם מערכות חיצוניות דרך פרוטוקול HTTP.

חשוב: כל הנתיבים שנקבעו מקבלים אוטומטית את הקידומת: /api/admin/workflows/endpoints/.

הגדרות צומת http in​

IMG2

1. שם​

שדה לציון שם הצומת.
השם מוצג באזור העבודה ועוזר לזהות בקלות את הצומת.
אם משאירים ריק, הצומת יקרא http in.

דוגמה:

  • שם הצומת: get payment link

2. שיטה​

שיטת HTTP שהצומת יעבד. האפשרויות הזמינות הן:

  • GET: משמש לקבלת נתונים.
  • POST: משמש לשליחת נתונים.
  • PUT: משמש לעדכון נתונים.
  • DELETE: משמש למחיקת נתונים.
  • PATCH: משמש לעדכון חלקי של נתונים.
  • OPTIONS: משמש לבקשות לקבלת מידע מטא על ה-API.

3. קישור​

מציין את הנתיב (endpoint) לעיבוד הבקשות.

  • הנתיב מתחיל ב- /.
  • יכול לכלול משתני נתיב, לדוגמה: /data/:id.

דוגמה:

  • קישור: /get-payment-link
  • קישור עם פרמטר: /get-payment-link/:orderId

פורמט הודעת כניסה​

כאשר הבקשה מגיעה לנתיב המצויין עם השיטה הנבחרת, הצומת http in יוצר הודעה msg עם התכונות הבאות:

  • msg.req: מכיל את אובייקט הבקשה HTTP, כולל כותרות, פרמטרים, גוף ונתונים אחרים.
    • msg.req.params: פרמטרי הנתיב (למשל, :id ב- /api/data/:id).
    • msg.req.query: פרמטרי GET של הבקשה.
    • msg.req.body: גוף הבקשה (לשיטות POST, PUT ו-PATCH).
  • msg.res: אובייקט לניהול התגובה HTTP. בדרך כלל מועבר לצומת http response לשליחת התגובה ללקוח.

דוגמת שימוש​

דוגמה 1: עיבוד בקשת GET​

תסריט: החזרת נתונים על טמפרטורה.

הגדרות הצומת:

  • שיטה: GET
  • קישור: /temperature

זרימה:

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

קוד הצומת function:

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

תוצאה: הלקוח ששלח בקשת GET ל- /api/admin/workflows/endpoints/temperature יקבל תגובת JSON:

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

דוגמה 2: עיבוד בקשת POST​

תסריט: קבלת ושמירת נתונים מהמכשיר.

הגדרות הצומת:

  • שיטה: POST
  • קישור: /data

זרימה:

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

קוד הצומת function:

// קריאת נתונים מגוף הבקשה
const data = msg.req.body;
msg.payload = { status: "success", receivedData: data };
return msg;

תוצאה: הצומת יקבל נתונים מגוף בקשת POST ויחזיר תגובה עם אישור.

דוגמה 3: שימוש בפרמטרי נתיב​

תסריט: קבלת נתונים לפי מזהה המכשיר.

הגדרות הצומת:

  • שיטה: GET
  • קישור: /device/:id

זרימה:

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

קוד הצומת function:

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

תוצאה:

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