Webhook (POST vers votre URL)
Un POST HTTP avec un corps JSON structuré dès qu'un scan réussit. Configurez une URL, une authentification HTTP Basic facultative, et c'est prêt. iOS et Android.
Webhooks et automatisation
iOSAndroidCinq actions intégrées se déclenchent dès que vous scannez un tag NFC, un QR code ou un code-barres - envoyez un POST à votre propre serveur, ouvrez l'URL, lancez un Raccourci, faites lire le résultat à voix haute ou jouez un son. NFC.cool est le scanner ; à vous l'action.
Les cinq actions
Raccourci (iOS)
Lorsqu'une URL scannée utilise le schéma `shortcuts://`, le Raccourci iOS correspondant se lance automatiquement - sans appui supplémentaire. Transmettez les données de scan à tout ce que l'app Raccourcis peut atteindre.
Ouverture de liens (iOS)
Lorsque le contenu est une URL classique, elle s'ouvre automatiquement dans Safari (ou la cible du lien profond correspondant). Fini l'étape « appuyer pour ouvrir ».
Synthèse vocale (iOS)
Faites lire le contenu scanné à voix haute, sans les mains. Débit de parole réglable. Pratique pour l'accessibilité, les situations où vous avez les mains occupées, ou simplement pour une confirmation agréable.
Lecture audio (iOS)
Jouez un son de confirmation à chaque scan - votre propre fichier audio ou l'une des tonalités intégrées.
Comment fonctionne le webhook
Déclencheurs - NFC, QR et code-barres
iOSAndroidLes webhooks se déclenchent à partir de trois sources d'événements : les scans NFC, les scans QR et les scans de codes-barres. Chaque source dispose de son propre interrupteur d'activation, ce qui vous permet d'envoyer les lectures NFC vers votre système d'inventaire sans que le scanner de l'appareil photo n'inonde le même point de terminaison. Le webhook, lui, reste identique - une URL, un corps JSON, un POST.
Structure de la charge utile
iOSAndroidChaque POST envoie un corps JSON de cette forme :
{
"identifier": "04:A2:7F:1B:5E:80:00",
"date": "2026-05-12T14:23:01Z",
"content": "Filament Spool #1234",
"tagType": "openPrintTag",
"structured": {
"material": "PLA",
"color": "#FF6F4C",
"manufacturer": "Prusament",
"uuid": "5e8a-7c1d-4f90"
}
}tagType et structured n'apparaissent que pour les formats spéciaux comme OpenPrintTag ; tous les autres scans n'envoient que les trois premiers champs. La référence développeur contient le détail champ par champ, l'authentification, curl et des serveurs d'exemple prêts à l'emploi.
Serveur de référence sur GitHub
iOSAndroidLe moyen le plus rapide de voir toute la boucle de bout en bout : le serveur web sur GitHub. Un serveur d'exemple minimal qui accepte les charges utiles des webhooks NFC.cool, les journalise et affiche leur structure en direct. Clonez-le, lancez-le, pointez votre iPhone dessus et regardez les scans arriver.
Détails techniques
Transport
- HTTPS recommandé ; HTTP autorisé en développement
- POST avec `Content-Type: application/json`
- Authentification HTTP Basic facultative (nom d'utilisateur + mot de passe)
- Identifiants stockés chiffrés dans le trousseau iOS
Charge utile
- `identifier` - UID du tag ou code scanné
- `date` - horodatage ISO 8601
- `content` - contenu décodé (chaîne d'URL, texte, etc.)
- `tagType` - présent pour les tags structurés (par ex. `openPrintTag`)
- `structured` - JSON imbriqué pour les types de tags structurés
Sources
- Scans NFC (lectures NDEF)
- Scans QR
- Scans de codes-barres
- Chaque source activable indépendamment
Free vs Platinum
| Free | Platinum | |
|---|---|---|
| Webhook NFC et QR | ✗ | ✓ |
| Synthétiseur vocal | ✗ | ✓ |
| Shortcuts | ✗ | ✓ |
| Synchronisation iCloud | ✓ | ✓ |
Questions fréquentes
Est-ce que cela fonctionne sur Android ?
Oui - les webhooks sont disponibles sur les versions iOS et Android de NFC.cool Tools. La structure de la charge utile JSON est identique sur les deux plateformes. (Les quatre autres actions iOS - Raccourci automatique, synthèse vocale, audio, ouverture de liens - sont réservées à iOS.)
Combien d'URL puis-je configurer ?
Une seule URL pour l'instant. Cette même URL reçoit tous les événements de scan, différenciés par les sources activées et le type de contenu.
Quelle authentification est prise en charge ?
L'authentification HTTP Basic - nom d'utilisateur + mot de passe, stockés chiffrés dans le trousseau iOS. Les jetons Bearer, les en-têtes personnalisés et la signature HMAC ne sont pas pris en charge pour le moment.
Que se passe-t-il si mon serveur est hors ligne ?
Le POST échoue et l'événement est journalisé sur l'appareil. Il n'y a pas encore de file de nouvelles tentatives automatiques ; si votre serveur risque d'être instable, concevez votre gestionnaire pour qu'il soit idempotent en cas de nouvelle tentative, puis relancez le webhook depuis l'historique des scans.
Y a-t-il une limite de taille pour la charge utile ?
Aucune limite stricte imposée par NFC.cool. Le contenu des tags est lui-même limité par la norme NFC (quelques Ko pour les tags NDEF courants).
Où puis-je le voir réellement fonctionner ?
Clonez le serveur web sur GitHub, lancez-le en local, pointez l'app dessus et vous verrez chaque scan arriver en temps réel.
Prêt à scanner ?