Pour ceux qui construisent

Où brancher NFC.cool

Un webhook n’est rien d’autre qu’un POST JSON vers une URL que vous contrôlez - donc tout ce qui parle HTTP fait l’affaire.

Modèles de workflow courants

• Inventaire et piste d’audit. Approchez un tag sur un article, NFC.cool envoie un POST vers un tableur ou un système d’entrepôt ; une ligne apparaît avec l’horodatage, l’identifiant du tag et le payload.

• Capture de leads en événement. Approchez un tag sur la banderole de votre stand, votre CRM déclenche automatiquement un e-mail de relance.

• Déclencheurs domotiques. Approchez un tag sur la porte d’entrée pour signaler “je suis rentré” - Home Assistant / Homey / Hubitat le récupère via webhook.

• Suivi des équipements. Le personnel de maintenance approche des tags sur les équipements pour consigner les inspections ; le backend constitue le registre de conformité.

• Enregistrement en conférence. Approchez le badge NFC d’un participant ; le webhook met à jour votre plateforme d’événement en temps réel.

Webhooks

Activez-les dans onglet Plus → Webhook à l’intérieur de l’app : saisissez une URL HTTPS, éventuellement un nom d’utilisateur/mot de passe pour l’authentification HTTP Basic, puis activez indépendamment “scans NFC” et “scans QR et codes-barres”. Disponible sur iOS et Android.

L’app envoie un seul POST par scan vers l’URL que vous avez configurée. Il n’y a pas de file de nouvelles tentatives séparée : si votre endpoint est injoignable ou renvoie une réponse non 2xx, le POST du scan échoue. Visez 204 No Content en cas de succès ; tout code 2xx est considéré comme accepté.

Cette page est la référence technique. Pour un aperçu de la fonctionnalité - les quatre autres points d’automatisation iOS, les tarifs et la FAQ - consultez la page de la fonctionnalité Webhooks et automatisation.

Payload du webhook

Content-type application/json, le corps est du JSON formaté :

{
  "identifier" : "04:A2:7F:1B:5E:80:00",
  "date" : "2026-05-12T14:23:01Z",
  "content" : "https://example.com/check-in/abc123"
}

Les tags structurés (actuellement OpenPrintTag) ajoutent deux champs supplémentaires :

{
  "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"
  }
}

Référence des champs :

• identifier - Pour les scans NFC, l’UID matériel du tag en hexadécimal majuscule séparé par des deux-points (par ex. 04:A2:7F:1B:5E:80:00). Stable par tag, vous pouvez donc l’utiliser pour la déduplication. Pour les scans QR et codes-barres, c’est un nouvel UUID à chaque scan - ce n’est pas un identifiant de code stable. Dans les anciens modes de compatibilité NFC d’iOS qui n’exposent pas l’UID, la valeur est la chaîne littérale NoIdentifierInCompatibilityMode.

• date - ISO 8601, moment où le scan a eu lieu sur l’appareil.

• content - Contenu décodé. Pour le NFC, la valeur de l’enregistrement NDEF (URI ou texte) ; pour les QR/codes-barres, la chaîne décodée brute.

• tagType - Omis pour les scans simples. Vaut "openPrintTag" pour les scans OpenPrintTag.

• structured - Omis pour les scans simples. Payload structuré analysé lorsque tagType est présent.

Authentification

Les webhooks prennent en charge uniquement l’authentification HTTP Basic. Dans onglet Plus → Webhook, vous pouvez éventuellement enregistrer un nom d’utilisateur et un mot de passe dans le Keychain iOS. L’app répond alors aux challenges HTTP standard 401 / WWW-Authenticate: Basic de votre serveur avec ces identifiants.

Autrement dit, c’est votre endpoint qui décide si l’authentification est requise. Si vous n’en avez pas besoin, laissez le nom d’utilisateur et le mot de passe vides dans l’app et ignorez le challenge côté serveur. Si vous en avez besoin, renvoyez un 401 avec WWW-Authenticate: Basic realm="…" sur le premier POST - l’appareil réessaiera avec Authorization: Basic … transportant les identifiants enregistrés. Tout transite par TLS ; les serveurs de NFC.cool ne voient jamais vos identifiants.

Il n’y a aujourd’hui aucune prise en charge des jetons Bearer, des clés API ou des signatures HMAC. Si vous en avez besoin, gérez-les au niveau d’un reverse proxy (Cloudflare Worker, nginx, etc.) qui traduit Basic vers votre schéma.

Exemples de récepteurs

Besoin de voir toute la boucle de bout en bout ? Clonez le serveur webhook de référence sur GitHub - il journalise chaque payload en direct. Les extraits ci-dessous sont des récepteurs minimaux pour votre propre stack.

cURL - test rapide

curl -X POST https://your-server.example/webhook \
  -u 'nfc-cool:your-password' \
  -H 'Content-Type: application/json' \
  -d '{"identifier":"04:A2:7F:1B:5E:80:00","date":"2026-05-12T14:00:00Z","content":"hello"}'

Node.js - récepteur Express

import express from "express";
import basicAuth from "express-basic-auth";

const app = express();
app.use(express.json());

app.post(
  "/webhook",
  basicAuth({
    users: { "nfc-cool": process.env.WEBHOOK_PASSWORD },
    challenge: true, // indique à NFC.cool de réessayer avec les identifiants
  }),
  (req, res) => {
    const { identifier, date, content, tagType } = req.body;
    console.log(`scan ${tagType ?? "plain"} ${content} id=${identifier} at ${date}`);
    res.status(204).end();
  }
);

app.listen(3000);

Python - récepteur FastAPI

import os
import secrets
from fastapi import FastAPI, Depends, HTTPException, Request, status
from fastapi.security import HTTPBasic, HTTPBasicCredentials

app = FastAPI()
security = HTTPBasic()

def check(creds: HTTPBasicCredentials = Depends(security)):
    ok_user = secrets.compare_digest(creds.username, "nfc-cool")
    ok_pass = secrets.compare_digest(creds.password, os.environ["WEBHOOK_PASSWORD"])
    if not (ok_user and ok_pass):
        raise HTTPException(
            status.HTTP_401_UNAUTHORIZED,
            headers={"WWW-Authenticate": 'Basic realm="nfc-cool"'},
        )

@app.post("/webhook")
async def webhook(request: Request, _: None = Depends(check)):
    body = await request.json()
    print(f"scan: {body['content']} id={body['identifier']}")
    return {"status": "ok"}

App Intents et Raccourcis

NFC.cool Tools sur iOS propose une poignée d’App Intents que vous pouvez intégrer à l’app Raccourcis, aux automatisations, aux modes de concentration ou à Apple Intelligence.

Les variantes dédiées à iOS 18 (NFC Scan, QR Scan, Document Scan, Object Scan, Room Scan) apparaissent directement dans Spotlight / le sélecteur du bouton d’action.

Schémas d’URL

Pour le deep-linking depuis d’autres apps iOS, des widgets ou des raccourcis de l’écran d’accueil, NFC.cool Tools enregistre ces URL :

nfcforiphone://scan-nfc
nfcforiphone://scan-code
nfcforiphone://scan-document
nfcforiphone://scan-object       (iOS 17+)
nfcforiphone://scan-room         (iOS 17+)

Ouvrir l’une de ces URL vous emmène directement dans le scanner correspondant. Les schémas nfc:// et geo:// sont également enregistrés pour prendre le relais des liens externes de tags ou de coordonnées.

Ressources lisibles par machine

Des flux repérables pour l’outillage, les moteurs de recherche et les agents IA :

Vous construisez quelque chose sur NFC.cool ? Ou vous avez repéré un partenaire d’intégration qui devrait figurer sur cette page ? Écrivez-nous.