Webhook (POST ke URL Anda)
HTTP POST dengan isi JSON terstruktur saat pemindaian berhasil. Konfigurasikan satu URL, autentikasi HTTP Basic opsional, dan selesai. iOS dan Android.
Webhook & Otomasi
iOSAndroidLima kait bawaan aktif saat Anda memindai tag NFC, kode QR, atau barcode - POST ke server Anda sendiri, buka URL, jalankan Shortcut, ucapkan hasilnya dengan lantang, atau putar suara. NFC.cool adalah pemindainya; Anda yang memiliki tindakannya.
Lima Kait
Shortcut (iOS)
Ketika URL yang dipindai memiliki skema `shortcuts://`, jalankan iOS Shortcut yang sesuai secara otomatis - tanpa ketukan tambahan. Kirimkan data pemindaian ke apa pun yang dapat dijangkau Shortcuts.
Buka Tautan (iOS)
Ketika payload berupa URL biasa, buka otomatis di Safari (atau target deep-link yang sesuai). Lewati langkah 'ketuk untuk membuka'.
Sintesis Suara (iOS)
Baca payload yang dipindai dengan lantang, tanpa tangan. Kecepatan bicara dapat dikonfigurasi. Berguna untuk aksesibilitas, alur kerja saat tangan sibuk, atau sekadar konfirmasi yang memuaskan.
Putar Audio (iOS)
Putar suara konfirmasi saat memindai - pilih file audio sendiri atau salah satu nada bawaan.
Cara Kerja Webhook
Pemicu - NFC, QR, dan Barcode
iOSAndroidWebhook aktif pada tiga sumber acara: pemindaian NFC, pemindaian QR, dan pemindaian barcode. Setiap sumber memiliki sakelar aktif/nonaktif tersendiri, sehingga Anda dapat mengirimkan pembacaan NFC ke sistem inventaris tanpa pemindai kamera yang mengisi endpoint yang sama. Webhook itu sendiri sama - satu URL, satu payload JSON, satu POST.
Bentuk Payload
iOSAndroidSetiap POST mengirimkan isi JSON berbentuk seperti ini:
{
"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 dan structured hanya muncul untuk format khusus seperti OpenPrintTag; setiap pemindaian lain hanya mengirimkan tiga bidang pertama. Referensi pengembang memiliki rincian lengkap per bidang, autentikasi, curl, dan contoh server yang siap dijalankan.
Server Referensi di GitHub
iOSAndroidCara tercepat untuk melihat seluruh alur dari awal hingga akhir: Server Web di GitHub. Contoh server minimal yang menerima payload webhook NFC.cool, mencatatnya, dan menampilkan strukturnya secara langsung. Clone, jalankan, arahkan iPhone Anda ke sana, dan saksikan pemindaian berdatangan.
Detail Teknis
Pengiriman
- HTTPS direkomendasikan; HTTP diizinkan dalam pengembangan
- POST dengan `Content-Type: application/json`
- HTTP Basic auth opsional (nama pengguna + kata sandi)
- Kredensial tersimpan terenkripsi di iOS Keychain
Payload
- `identifier` - UID tag atau kode yang dipindai
- `date` - stempel waktu ISO 8601
- `content` - payload yang telah didekode (string URL, teks, dll.)
- `tagType` - ada untuk tag terstruktur (misalnya `openPrintTag`)
- `structured` - JSON bertingkat untuk jenis tag terstruktur
Sumber
- Pemindaian NFC (pembacaan NDEF)
- Pemindaian QR
- Pemindaian barcode
- Setiap sumber dapat diaktifkan secara independen
Gratis vs Platinum
| Gratis | Platinum | |
|---|---|---|
| Webhook NFC & QR | ✗ | ✓ |
| Synthesizer Suara | ✗ | ✓ |
| Shortcuts | ✗ | ✓ |
| iCloud Sync | ✓ | ✓ |
Pertanyaan Umum
Apakah ini berfungsi di Android?
Ya - webhook tersedia di versi iOS dan Android dari NFC.cool Tools. Bentuk payload JSON sama di semua platform. (Empat kait iOS lainnya - Shortcut otomatis, suara, audio, buka tautan - hanya untuk iOS.)
Berapa banyak URL yang bisa saya konfigurasikan?
Satu URL saat ini. URL yang sama menerima semua acara pemindaian, dibedakan oleh sakelar sumber yang diaktifkan dan jenis payload.
Autentikasi apa yang didukung?
HTTP Basic auth - nama pengguna + kata sandi, tersimpan terenkripsi di iOS Keychain. Bearer token, header khusus, dan penandatanganan HMAC saat ini tidak didukung.
Apa yang terjadi jika server saya offline?
POST gagal dan acara dicatat di perangkat. Saat ini tidak ada antrean percobaan ulang otomatis; jika server Anda mungkin tidak stabil, rancang handler Anda agar idempoten saat percobaan ulang dan picu ulang dari riwayat pemindaian.
Apakah ada batas ukuran payload?
Tidak ada batas keras yang diterapkan oleh NFC.cool. Payload tag itu sendiri dibatasi oleh standar NFC (beberapa KB untuk tag NDEF tipikal).
Di mana saya bisa melihatnya bekerja?
Clone Server Web di GitHub, jalankan secara lokal, arahkan aplikasi ke sana, dan Anda akan melihat setiap pemindaian tiba secara real time.
Siap untuk memindai?