Вебхук (POST на твой адрес)
HTTP POST со структурированным телом JSON сразу после удачного сканирования. Укажи один адрес, при необходимости логин и пароль HTTP Basic, и всё готово. Работает на iOS и Android.
Вебхуки и автоматизация
iOSAndroidПять встроенных сценариев срабатывают в момент, когда считана NFC-метка, QR-код или штрихкод: POST на твой сервер, открытие ссылки, запуск быстрой команды, чтение результата вслух или звуковой сигнал. NFC.cool отвечает за сканирование, а действие остаётся за тобой.
Пять сценариев
Быстрая команда (iOS)
Если в считанной ссылке схема `shortcuts://`, нужная быстрая команда запустится сама, без лишнего касания. Данные скана уходят туда, куда дотягиваются «Быстрые команды».
Открытие ссылок (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 (логин и пароль)
- Учётные данные хранятся в зашифрованном виде в Keychain на iOS
Тело запроса
- `identifier`, UID метки или считанный код
- `date`, отметка времени в формате ISO 8601
- `content`, разобранное содержимое (ссылка, текст и так далее)
- `tagType`, есть у структурированных меток (например, `openPrintTag`)
- `structured`, вложенный JSON для структурированных типов меток
Источники
- Сканирование NFC (чтение NDEF)
- Сканирование QR
- Сканирование штрихкодов
- Каждый источник включается отдельно
Бесплатно и Platinum
| Бесплатно | Platinum | |
|---|---|---|
| Вебхуки для NFC и QR | ✗ | ✓ |
| Синтезатор речи | ✗ | ✓ |
| Быстрые команды | ✗ | ✓ |
| Синхронизация с iCloud | ✓ | ✓ |
Частые вопросы
Это работает на Android?
Да, вебхуки есть и в версии NFC.cool Tools для iOS, и в версии для Android. Тело JSON на обеих платформах одинаковое. (Остальные четыре сценария, то есть автозапуск быстрой команды, речь, звук и открытие ссылок, доступны только на iOS.)
Сколько адресов можно настроить?
Пока один. На этот адрес приходят все события сканирования, а различать их можно по включённым источникам и по типу содержимого.
Какая авторизация поддерживается?
HTTP Basic, то есть логин и пароль, которые хранятся в зашифрованном виде в Keychain на iOS. Токены Bearer, свои заголовки и подпись HMAC пока не поддерживаются.
Что будет, если сервер недоступен?
POST завершится ошибкой, а событие останется в журнале на устройстве. Очереди повторных попыток пока нет, поэтому если сервер бывает нестабильным, сделай обработчик идемпотентным и повторяй отправку из истории сканирований.
Есть ли ограничение на размер?
Со стороны NFC.cool жёсткого предела нет. Само содержимое метки ограничено стандартом NFC, а это несколько килобайт для обычных меток NDEF.
Где посмотреть, как это работает вживую?
Склонируй веб-сервер на GitHub, запусти его локально, направь на него приложение, и каждое сканирование будет прилетать в реальном времени.
Готов сканировать?
★4,5·73 500 оценок·Бесплатно