מדריך זרימות

דף זה מסביר איך Scan 2 Flow עובד, במיוחד זרימות והפעולות שאפשר להריץ כשסורקים ברקוד או קוד QR.

🎯 What is a Workflow?

A workflow is an automated action triggered by scanning a barcode or QR code. When you scan, your device matches the code against your workflows - by code format or pattern - and automatically executes the corresponding action without any manual input.

Action Methods

Each workflow uses one action method. All examples use event tickets for simplicity - you can apply the same patterns to any use case. Test each action with our demo project.

פתיחת URL

פותח כתובת בדפדפן. אפשר להשתמש ב-placeholder {{data}} בכתובת; הוא מוחלף בערך הסרוק. לדוגמה: https://www.google.com/search?q={{data}}. בחר אם לפתוח בטאב חדש או באותו טאב.

Example: demo-endpoint/view-ticket.html?ticket_id=

קריאת API

שולח בקשת POST לכתובת שתציין. גוף הבקשה הוא JSON עם שדה 'data' (הערך הסרוק) ושדה 'format' (למשל QR_CODE). התגובה אינה מוצגת באפליקציה; שימוש ל-webhooks, Make, n8n או כל נקודת קצה HTTP.

Example: GET demo-endpoint/api/tickets?ticket_id=
Validates ticket silently - failed calls turn red in scan log (no beep, visual feedback only)

קריאת API וביפ לפי סטטוס

כמו קריאת API, אבל האפליקציה משמעת ביפ הצלחה כשה-backend מחזיר HTTP 200 וביפ כישלון לכל סטטוס אחר. מתאים לרישום או אימות בדלת: הצוות מקבל משוב קולי מיידי בלי להביט במסך. הפעל צליל ביפ בהגדרות.

Example: https://vocal-kitsune-c6bf6b.netlify.app/api/tickets?ticket_id=
Valid: TCKT-1001 → 200 (valid:true) beep | Invalid: TCKT-1003 → 200 (valid:false) beep | Not found: TCKT-9999 → 404 beep

קריאת API ותצוגה

כמו קריאת API, אבל האפליקציה מבקשת את הכתובת (GET או POST עם נתוני הסריקה), ואז מציגה שדות נבחרים מתגובת ה-JSON בטבלה. הגדר "שדות לתצוגה" עם נתיבים מופרדים בפסיק (למשל data.price, data.name) או השאר ריק להצגת התגובה המלאה.

Example: GET demo-endpoint/api/tickets?ticket_id=
Display fields: ticket_id, attendee_name, valid, valid_until

קריאת API ורינדור HTML

קורא ל-API (GET עם ערך הסריקה בכתובת דרך {{data}}), ואז מציג תבנית HTML במודל full-screen. התבנית היא HTML עם placeholders (למשל {{title}}) שמוחלפים בערכים מתגובת ה-JSON של ה-API.

Example: https://vocal-kitsune-c6bf6b.netlify.app/api/tickets?ticket_id=
Template includes form to update ticket details (name, valid_until, valid status)

טעינת קישור בתוך iframe

טוען דף אינטרנט חיצוני בתוך iframe. השתמש בתבנית URL עם {{data}} כדי להעביר את הערך הסרוק, למשל: https://example.com/item?id={{data}}.

Example: demo-endpoint/view-ticket.html?ticket_id=

מתי זרימה רצה?

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

  • פורמט: הגבלה לסוגי ברקוד ספציפיים (למשל רק QR) או "כל פורמט" להתאמה לכל הפורמטים המופעלים.
  • תבנית: הפעל "התאמת תבנית" והזן ביטוי רגולרי. הזרימה רצה רק כשהטקסט הסרוק תואם ל-regex.

API למפתחים

ל-API ברקוד ו-QR יש שתי נקודות קצה: (1) פענוח - POST /api/parse-code קורא ברקודים ו-QR מתמונות (base64 או כתובת) ומחזיר את הנתונים. (2) יצירה - GET /api/generate-qrcode יוצר תמונות QR מטקסט. ראה מראה מקום API למטה.

מראה מקום API