Webhook (POST an deine URL)
HTTP POST mit strukturiertem JSON-Body im Moment des Scans. Eine URL konfigurieren, optional HTTP Basic Auth, fertig. iOS und Android.
Webhooks & Automatisierung
iOSAndroidFünf eingebaute Hooks feuern im Moment, in dem du einen NFC-Tag, einen QR-Code oder einen Barcode scannst - POST an deinen Server, URL automatisch öffnen, Shortcut starten, Ergebnis vorlesen oder Sound abspielen. NFC.cool ist der Scanner; die Aktion gehört dir.
Die fünf Hooks
Shortcut (iOS)
Bei einer gescannten URL mit Schema <code>shortcuts://</code> startet automatisch der passende iOS-Shortcut - ohne weiteren Tap. Speise Scan-Daten in alles, was Shortcuts erreichen kann.
Links öffnen (iOS)
Bei einer normalen URL als Payload öffnet sich Safari (oder das passende Deep-Link-Ziel) automatisch. Der „Tippen zum Öffnen“-Schritt entfällt.
Sprachausgabe (iOS)
Liest die Payload laut vor, freihändig. Sprechgeschwindigkeit einstellbar. Nützlich für Barrierefreiheit, hands-busy-Workflows oder einfach zur Bestätigung.
Audio abspielen (iOS)
Spielt einen Bestätigungston beim Scannen - deine eigene Audiodatei oder einer der eingebauten Töne.
Wie der Webhook funktioniert
Auslöser - NFC, QR und Barcode
iOSAndroidWebhooks feuern bei drei Event-Quellen: NFC-Scans, QR-Scans, Barcode-Scans. Jede Quelle hat ihren eigenen Ein-/Aus-Schalter, sodass du z. B. NFC-Lesungen ins Inventur-System schicken kannst, ohne dass der Kamera-Scanner denselben Endpunkt zuspammt. Der Webhook selbst ist immer derselbe - eine URL, ein JSON-Payload, ein POST.
Payload-Form
iOSAndroidJeder POST sendet einen JSON-Body in dieser Form:
{
"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 und structured erscheinen nur bei speziellen Formaten wie OpenPrintTag; jeder andere Scan sendet nur die ersten drei Felder. Die Entwickler-Referenz enthält die vollständige Feld-für-Feld-Aufschlüsselung, Authentifizierung, curl und einsatzfertige Beispiel-Server.
Referenz-Server auf GitHub
iOSAndroidDer schnellste Weg, den ganzen Kreislauf zu sehen: Web-Server auf GitHub. Ein minimaler Beispiel-Server, der NFC.cool-Webhook-Payloads empfängt, loggt und die Struktur live zeigt. Klonen, starten, iPhone darauf richten, Scans landen sehen.
Technische Details
Transport
- HTTPS empfohlen; HTTP für Dev erlaubt
- POST mit `Content-Type: application/json`
- Optional HTTP Basic Auth (Benutzername + Passwort)
- Zugangsdaten verschlüsselt im iOS-Keychain
Payload
- `identifier` - Tag-UID oder gescannter Code
- `date` - ISO-8601-Zeitstempel
- `content` - dekodierte Payload (URL-String, Text usw.)
- `tagType` - vorhanden bei strukturierten Tags (z. B. `openPrintTag`)
- `structured` - verschachteltes JSON für strukturierte Tag-Typen
Quellen
- NFC-Scans (NDEF-Lesungen)
- QR-Scans
- Barcode-Scans
- Jede Quelle einzeln aktivierbar
Free vs Platinum
| Free | Platinum | |
|---|---|---|
| NFC & QR Webhook | ✗ | ✓ |
| Sprachgenerator | ✗ | ✓ |
| Kurzbefehle | ✗ | ✓ |
| iCloud-Synchronisation | ✓ | ✓ |
Häufig gefragt
Funktioniert das auf Android?
Ja - Webhooks sind sowohl in der iOS- als auch in der Android-Version von NFC.cool Tools verfügbar. Die JSON-Payload-Form ist plattformübergreifend gleich. (Die anderen vier iOS-Hooks - Auto-Shortcut, Sprachausgabe, Audio, Link-Öffnen - sind iOS-only.)
Wie viele URLs kann ich konfigurieren?
Heute eine URL. Dieselbe URL empfängt alle Scan-Events, unterschieden durch die aktivierten Quell-Schalter und den Payload-Typ.
Welche Authentifizierung wird unterstützt?
HTTP Basic Auth - Benutzername + Passwort, verschlüsselt im iOS-Keychain. Bearer-Token, Custom-Header und HMAC-Signaturen werden derzeit nicht unterstützt.
Was passiert, wenn mein Server offline ist?
Der POST schlägt fehl und das Ereignis wird auf dem Gerät geloggt. Eine automatische Retry-Queue gibt es heute nicht; baue deinen Handler idempotent und triggere im Zweifel aus dem Scan-Verlauf neu.
Gibt es ein Payload-Größenlimit?
Kein hartes Limit seitens NFC.cool. Die Tag-Payloads selbst sind durch den NFC-Standard begrenzt (wenige KB für typische NDEF-Tags).
Wo kann ich es live sehen?
Klone den Web-Server auf GitHub, starte ihn lokal, richte die App darauf - und beobachte, wie die Scans in Echtzeit eintreffen.
Bereit zum Scannen?