Webhook (POST a tu URL)
HTTP POST con un cuerpo JSON estructurado en el momento en que un escaneo tiene éxito. Configura una URL, autenticación HTTP Basic opcional, y listo. iOS y Android.
Webhooks y automatización
iOSAndroidCinco disparadores incorporados se activan en el momento en que escaneas una etiqueta NFC, un código QR o un código de barras - POST a tu propio servidor, abre la URL, ejecuta un Atajo, lee el resultado en voz alta o reproduce un sonido. NFC.cool es el escáner; tú controlas la acción.
Los cinco disparadores
Atajo (iOS)
Cuando una URL escaneada tiene un esquema `shortcuts://`, ejecuta automáticamente el Atajo de iOS correspondiente - sin un toque adicional. Canaliza los datos del escaneo hacia todo lo que Atajos puede alcanzar.
Abrir enlaces (iOS)
Cuando el payload es una URL normal, ábrela automáticamente en Safari (o en el destino de enlace directo correspondiente). Sáltate el paso de 'tocar para abrir'.
Síntesis de voz (iOS)
Lee el payload escaneado en voz alta, con las manos libres. Velocidad de la voz configurable. Útil para accesibilidad, flujos de trabajo con las manos ocupadas, o simplemente como confirmación satisfactoria.
Reproducir audio (iOS)
Reproduce un sonido de confirmación al escanear - tu propio archivo de audio a elegir o uno de los tonos incorporados.
Cómo funciona el webhook
Disparadores - NFC, QR y código de barras
iOSAndroidLos webhooks se activan a partir de tres fuentes de eventos: escaneos NFC, escaneos QR y escaneos de códigos de barras. Cada fuente tiene su propio interruptor de activar/desactivar, así que puedes canalizar las lecturas NFC hacia tu sistema de inventario sin que el escáner de cámara inunde el mismo endpoint. El webhook en sí es el mismo - una URL, un payload JSON, un POST.
Estructura del payload
iOSAndroidCada POST envía un cuerpo JSON con esta forma:
{
"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"
}
}Los campos tagType y structured aparecen solo en formatos especiales como OpenPrintTag; cualquier otro escaneo envía solo los tres primeros campos. La referencia para desarrolladores tiene el desglose completo campo a campo, autenticación, curl y servidores de ejemplo listos para ejecutar.
Servidor de referencia en GitHub
iOSAndroidLa forma más rápida de ver el ciclo completo de principio a fin: Servidor web en GitHub. Un servidor de ejemplo mínimo que acepta los payloads de webhook de NFC.cool, los registra y muestra la estructura en directo. Clónalo, ejecútalo, apunta tu iPhone hacia él y observa cómo llegan los escaneos.
Detalles técnicos
Transporte
- HTTPS recomendado; HTTP permitido en desarrollo
- POST con `Content-Type: application/json`
- Autenticación HTTP Basic opcional (nombre de usuario + contraseña)
- Credenciales guardadas cifradas en el Keychain de iOS
Payload
- `identifier` - UID de la etiqueta o código escaneado
- `date` - fecha y hora en ISO 8601
- `content` - payload decodificado (cadena de URL, texto, etc.)
- `tagType` - presente en etiquetas estructuradas (p. ej. `openPrintTag`)
- `structured` - JSON anidado para tipos de etiqueta estructurados
Fuentes
- Escaneos NFC (lecturas NDEF)
- Escaneos QR
- Escaneos de códigos de barras
- Cada fuente se puede activar de forma independiente
Gratis vs Platinum
| Gratis | Platinum | |
|---|---|---|
| Webhook NFC y QR | ✗ | ✓ |
| Sintetizador de voz | ✗ | ✓ |
| Atajos | ✗ | ✓ |
| Sincronización con iCloud | ✓ | ✓ |
Preguntas frecuentes
¿Esto funciona en Android?
Sí - los webhooks están disponibles en las versiones de iOS y Android de NFC.cool Tools. La estructura del payload JSON es la misma en todas las plataformas. (Los otros cuatro disparadores de iOS - Atajo automático, voz, audio, apertura de enlaces - son solo para iOS.)
¿Cuántas URLs puedo configurar?
Una URL actualmente. La misma URL recibe todos los eventos de escaneo, distinguidos por los interruptores de fuente activados y por el tipo de payload.
¿Qué autenticación se admite?
Autenticación HTTP Basic - nombre de usuario + contraseña, guardados cifrados en el Keychain de iOS. Los tokens Bearer, las cabeceras personalizadas y la firma HMAC no se admiten actualmente.
¿Qué pasa si mi servidor está sin conexión?
El POST falla y el evento queda registrado en el dispositivo. Hoy no existe una cola de reintentos automática; si tu servidor puede ser inestable, diseña tu handler para que sea idempotente en el reintento y vuelve a dispararlo desde el historial de escaneos.
¿Hay un límite de tamaño del payload?
Ningún límite estricto impuesto por NFC.cool. Los propios payloads de las etiquetas están limitados por el estándar NFC (unos pocos KB para las etiquetas NDEF típicas).
¿Dónde puedo verlo funcionar de verdad?
Clona el Servidor web en GitHub, ejecútalo localmente, apunta la app hacia él y verás llegar cada escaneo en tiempo real.
¿Listo para escanear?