Guide des flux

Cette page explique le fonctionnement de Scan 2 Flow, en particulier les flux et les actions exécutées lorsqu'un code-barres ou QR est scanné.

🎯 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.

Ouvrir une URL

Ouvre une URL dans le navigateur. Vous pouvez utiliser le placeholder {{data}} dans l'URL ; il est remplacé par la valeur scannée. Ex. : https://www.google.com/search?q={{data}}. Choisissez d'ouvrir dans un nouvel onglet ou le même.

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

Appel API

Envoie une requête POST à l'URL indiquée. Le corps de la requête est du JSON avec un champ 'data' (la valeur scannée) et un champ 'format' (ex. QR_CODE). La réponse n'est pas affichée dans l'app ; utilisez pour webhooks, Make, n8n ou tout endpoint HTTP.

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

Appel API et bip selon statut

Comme Appel API, mais l'app joue un bip succès quand votre backend renvoie HTTP 200 et un bip échec pour tout autre statut. Idéal pour enregistrement ou validation à l'entrée : le personnel a un retour audio instantané sans regarder l'écran. Activez le bip dans Paramètres.

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

Appel API et affichage

Comme Appel API, mais l'app appelle l'URL (GET ou POST avec les données du scan), puis affiche des champs choisis de la réponse JSON dans un tableau. Configurez « Champs à afficher » avec des chemins séparés par des virgules (ex. data.price, data.name) ou laissez vide pour la réponse complète.

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

Appel API et rendu HTML

Appelle l'API (GET avec la valeur du scan dans l'URL via {{data}}), puis affiche un modèle HTML dans une modale plein écran. Le modèle est du HTML avec des placeholders (ex. {{title}}) remplacés par les valeurs de la réponse JSON de l'API.

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

Charger un lien dans l'iframe

Charge une page web externe dans une iframe. Utilisez un modèle d'URL avec {{data}} pour passer la valeur scannée, par exemple : https://example.com/item?id={{data}}.

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

Quand un flux s'exécute-t-il ?

Un flux s'exécute quand le scan correspond à ses filtres. Vous pouvez restreindre par format et par motif :

  • Format : limiter à certains types de codes (ex. QR uniquement) ou « Tout format » pour tous les formats activés.
  • Motif : activez « Correspondance de motif » et entrez une expression régulière. Le flux ne s'exécute que si le texte scanné correspond.

API développeur

L'API Codes-barres et QR propose deux endpoints : (1) Décodage - POST /api/parse-code lit les codes-barres et QR dans les images (base64 ou URL) et renvoie les données. (2) Génération - GET /api/generate-qrcode crée des images QR à partir de texte. Voir la référence API ci-dessous.

Référence API