Вебхук (POST на твою адресу)
HTTP POST зі структурованим тілом JSON тієї ж миті, коли сканування вдалося. Вкажи одну адресу, за потреби логін і пароль HTTP Basic, і на цьому все. iOS та Android.
Вебхуки й автоматизація
iOSAndroidП'ять вбудованих автодій спрацьовують тієї ж миті, коли зчитано NFC-мітку, QR-код чи штрихкод: POST на власний сервер, відкриття посилання, запуск Швидкої команди, озвучення результату або звуковий сигнал. NFC.cool лишається сканером, а дія належить тобі.
П'ять автодій
Швидка команда (iOS)
Коли зчитане посилання має схему `shortcuts://`, потрібна Швидка команда iOS запускається сама, без зайвого натискання. Дані сканування підуть усюди, куди дістають Швидкі команди.
Відкриття посилань (iOS)
Якщо на мітці звичайне посилання, воно відкриється в Safari або у відповідному застосунку. Крок «натисни, щоб відкрити» просто зникає.
Синтез мовлення (iOS)
Прочитає зчитаний вміст уголос. Швидкість мовлення налаштовується. Корисно для доступності, для роботи із зайнятими руками або просто як приємне підтвердження.
Звуковий сигнал (iOS)
Підтверджує сканування звуком: або власним аудіофайлом, або одним із вбудованих тонів.
Як працює вебхук
Що запускає вебхук: NFC, QR і штрихкоди
iOSAndroidВебхуки спрацьовують на трьох джерелах подій: зчитування NFC, сканування QR і сканування штрихкодів. У кожного джерела свій вимикач, тож зчитування NFC можна надсилати в систему обліку, а сканер камери не завалюватиме ту саму адресу. Сам вебхук при цьому один: одна адреса, одне тіло JSON, один POST.
Що приходить у тілі запиту
iOSAndroidКожен POST надсилає тіло JSON такого вигляду:
{
"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 і structured приходять тільки з особливими форматами на кшталт OpenPrintTag, а будь-яке інше сканування надсилає лише три перші поля. У довіднику для розробників розібрано кожне поле, авторизацію, приклади curl і готові до запуску сервери.
Приклад сервера на GitHub
iOSAndroidНайшвидший спосіб побачити весь ланцюжок від початку до кінця: вебсервер на GitHub. Мінімальний приклад сервера, який приймає вміст вебхуків NFC.cool, записує його в журнал і показує структуру наживо. Клонуй, запусти, піднеси мітку до iPhone і дивись, як прилітають сканування.
Технічні подробиці
Передавання
- HTTPS бажаний, HTTP дозволений для розробки
- POST із заголовком `Content-Type: application/json`
- За потреби HTTP Basic auth (логін і пароль)
- Дані для входу зберігаються зашифрованими в Keychain на iOS
Тіло запиту
- `identifier`: UID мітки або зчитаний код
- `date`: позначка часу за ISO 8601
- `content`: розібраний вміст (посилання, текст тощо)
- `tagType`: приходить зі структурованими мітками (наприклад, `openPrintTag`)
- `structured`: вкладений JSON для структурованих типів міток
Джерела
- Зчитування NFC (записи NDEF)
- Сканування QR
- Сканування штрихкодів
- Кожне джерело вмикається окремо
Безкоштовно і Platinum
| Безкоштовно | Platinum | |
|---|---|---|
| Вебхук для NFC і QR | ✗ | ✓ |
| Синтез мовлення | ✗ | ✓ |
| Швидкі команди | ✗ | ✓ |
| Синхронізація через iCloud | ✓ | ✓ |
Часті питання
Чи працює це на Android?
Так, вебхуки є і в iOS-версії NFC.cool Tools, і в Android-версії. Тіло JSON має однакову структуру на обох платформах. (Решта чотирьох автодій, тобто автозапуск Швидкої команди, озвучення, звук і відкриття посилань, працюють лише на iOS.)
Скільки адрес можна налаштувати?
Наразі одну. На неї приходять усі події сканування, а розрізняти їх допомагають увімкнені джерела й тип вмісту.
Яка авторизація підтримується?
HTTP Basic auth: логін і пароль, які зберігаються зашифрованими в Keychain на iOS. Токени Bearer, власні заголовки й підпис HMAC поки не підтримуються.
Що буде, якщо мій сервер лежить?
POST не пройде, а подія залишиться в журналі на пристрої. Автоматичної черги повторів поки немає, тож якщо сервер буває нестабільний, зроби обробник стійким до повторів і надішли подію ще раз з історії сканувань.
Чи є обмеження на розмір вмісту?
З боку NFC.cool жорсткого обмеження немає. Сам вміст мітки обмежує стандарт NFC (кілька кілобайтів для звичайних міток NDEF).
Де подивитися, як це працює насправді?
Клонуй вебсервер із GitHub, запусти його локально, вкажи його адресу в застосунку, і кожне сканування прилітатиме просто на очах.
Готовий сканувати?
★4,5·73 500 оцінок·Безкоштовно