Webhook (POST al tuo URL)
Una POST HTTP con un corpo JSON strutturato appena la scansione va a buon fine. Imposti un URL e, se serve, l'autenticazione HTTP Basic: hai finito. Su iOS e Android.
Webhook e automazione
iOSAndroidCinque automatismi integrati scattano nell'istante in cui scansioni un tag NFC, un codice QR o un codice a barre: una POST verso il tuo server, l'apertura dell'URL, l'avvio di un Comando rapido, il risultato letto ad alta voce o un suono. NFC.cool fa la scansione, l'azione la scegli tu.
I cinque automatismi
Comando rapido (iOS)
Quando l'URL scansionato usa lo schema `shortcuts://`, il Comando rapido corrispondente parte da solo, senza un tocco in più. Così i dati della scansione finiscono ovunque arrivino i Comandi Rapidi.
Apertura dei link (iOS)
Quando il contenuto è un URL normale, si apre da solo in Safari (o nell'app collegata al deep link). Il passaggio 'tocca per aprire' sparisce.
Sintesi vocale (iOS)
L'app legge ad alta voce il contenuto scansionato, senza che tu debba toccare niente. La velocità della voce è regolabile. Comoda per l'accessibilità, per quando hai le mani occupate o semplicemente come conferma.
Riproduzione audio (iOS)
Un suono di conferma a ogni scansione: scegli un file audio tuo oppure uno dei toni già inclusi.
Come funziona il webhook
Da dove parte: NFC, QR e codici a barre
iOSAndroidI webhook partono da tre tipi di evento: scansioni NFC, scansioni QR e scansioni di codici a barre. Ogni sorgente ha il suo interruttore, così le letture NFC finiscono nel tuo gestionale di magazzino senza che lo scanner della fotocamera intasi lo stesso endpoint. Il webhook resta comunque uno solo: un URL, un payload JSON, una POST.
Com'è fatto il payload
iOSAndroidOgni POST invia un corpo JSON fatto così:
{
"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"
}
}I campi tagType e structured compaiono solo nei formati speciali come OpenPrintTag; tutte le altre scansioni inviano soltanto i primi tre campi. Nella documentazione per sviluppatori trovi la descrizione campo per campo, l'autenticazione, gli esempi con curl e alcuni server pronti da avviare.
Il server di esempio su GitHub
iOSAndroidIl modo più rapido per vedere l'intero giro, dall'inizio alla fine: Server web su GitHub. È un server di esempio essenziale che riceve i payload dei webhook di NFC.cool, li registra e ne mostra la struttura in tempo reale. Clonalo, avvialo, punta l'iPhone su un tag e guarda le scansioni arrivare.
Dettagli tecnici
Trasporto
- HTTPS consigliato; HTTP ammesso in fase di sviluppo
- POST con `Content-Type: application/json`
- Autenticazione HTTP Basic facoltativa (nome utente e password)
- Credenziali salvate cifrate nel Portachiavi di iOS
Payload
- `identifier` - UID del tag o codice scansionato
- `date` - data e ora in formato ISO 8601
- `content` - contenuto decodificato (indirizzo web, testo e simili)
- `tagType` - presente nei tag strutturati (per esempio `openPrintTag`)
- `structured` - JSON annidato per i tipi di tag strutturati
Sorgenti
- Scansioni NFC (letture NDEF)
- Scansioni QR
- Scansioni di codici a barre
- Ogni sorgente si attiva o si disattiva separatamente
Gratis vs Platinum
| Gratis | Platinum | |
|---|---|---|
| Webhook per NFC e QR | ✗ | ✓ |
| Sintesi vocale | ✗ | ✓ |
| Comandi Rapidi | ✗ | ✓ |
| Sincronizzazione iCloud | ✓ | ✓ |
Domande frequenti
Funziona anche su Android?
Sì, i webhook ci sono sia nella versione iOS sia in quella Android di NFC.cool Tools e il payload JSON ha la stessa struttura su entrambe le piattaforme. Gli altri quattro automatismi (avvio del Comando rapido, sintesi vocale, audio e apertura dei link) sono invece solo per iOS.
Quanti URL posso configurare?
Per ora uno soltanto. Lo stesso indirizzo riceve tutti gli eventi di scansione, distinti dalle sorgenti che hai attivato e dal tipo di contenuto.
Quale autenticazione è supportata?
L'autenticazione HTTP Basic, con nome utente e password salvati cifrati nel Portachiavi di iOS. Al momento non sono supportati i token Bearer, le intestazioni personalizzate e la firma HMAC.
Cosa succede se il mio server non risponde?
La POST fallisce e l'evento resta registrato sul dispositivo. Per ora non c'è una coda di reinvio automatico: se il server può risultare instabile, scrivi un gestore idempotente, che regga senza effetti collaterali un secondo invio identico, e rilancia la chiamata dalla cronologia delle scansioni.
C'è un limite alla dimensione del payload?
NFC.cool non ne impone nessuno. Sono i contenuti dei tag a essere limitati dallo standard NFC: qualche KB per i tag NDEF più comuni.
Dove posso vederlo all'opera?
Clona il Server web su GitHub, avvialo in locale, imposta l'app su quell'indirizzo e vedrai arrivare ogni scansione in tempo reale.
Pronto a scansionare?
★4,5·73.500 valutazioni·Gratis