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:A3:B2:81:C5:6E:80",
"date": "2026-05-15T10:42:18Z",
"content": "https://example.com/product/42",
"tagType": "openPrintTag",
"structured": {
"material": "PLA",
"color": "#FF6F4C",
"manufacturer": "Prusament",
"uuid": "5e8a-…"
}
}identifier ist die Tag-UID oder der gescannte Code. date ist ISO 8601. content ist die dekodierte Payload. tagType und structured erscheinen nur bei speziellen Formaten wie OpenPrintTag – andere Scans lassen sie weg.
Curl-Beispiel
iOSAndroidSo sieht es auf der Serverseite aus – das curl-Äquivalent für eine normale URL-Payload:
curl -X POST https://dein-server.example.com/scans \
-H "Content-Type: application/json" \
-u "benutzername:passwort" \
-d '{
"identifier": "04:A3:B2:81:C5:6E:80",
"date": "2026-05-15T10:42:18Z",
"content": "https://example.com/menu"
}'Das -u-Flag entspricht dem, was NFC.cool sendet, wenn HTTP Basic Auth in den Einstellungen konfiguriert ist – Benutzername und Passwort liegen verschlüsselt im iOS-Keychain.
Referenz-Server auf GitHub
iOSAndroidDer schnellste Weg, den ganzen Kreislauf zu sehen: github.com/NickAtGit/nfc-cool-webhook-server. 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 | |
|---|---|---|
| URLs beim Scannen automatisch öffnen | ✓ | ✓ |
| Shortcuts bei Shortcut-URL-Scan ausführen | ✓ | ✓ |
| Audio beim Scannen abspielen | ✓ | ✓ |
| Sprachausgabe (vorlesen) | ✗ | ✓ |
| Webhook (POST an deine URL) | ✗ | ✓ |
| Quelle pro Quelle ein-/ausschalten (NFC vs Kamera) | ✗ | ✓ |
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 Referenz-Server github.com/NickAtGit/nfc-cool-webhook-server, starte ihn lokal, richte die App darauf – und beobachte, wie die Scans in Echtzeit eintreffen.
Bereit zum Scannen?