Webhook & オートメーション

Webhookは3つのイベントソースで発火します: NFCスキャン、QRスキャン、バーコードスキャン。それぞれに有効/無効のトグルがあり、たとえばNFCの読み取りだけを在庫システムへ流し、カメラスキャナーで同じエンドポイントを連打しないようにできます。Webhook自体はすべて同じ - 1つのURL、1つのJSONペイロード、1つのPOSTです。

各POSTはこの形のJSONボディを送ります:

{
  "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 はタグUIDまたはスキャンされたコード。date はISO 8601。content はデコードされたペイロード。tagType と structured は OpenPrintTag のような特殊形式の時のみ含まれます - 他のスキャンでは省略されます。

サーバー側で受け取るものはこんな感じです - 通常のURLペイロードの curl 相当:

curl -X POST https://your-server.example.com/scans \
  -H "Content-Type: application/json" \
  -u "username:password" \
  -d '{
    "identifier": "04:A3:B2:81:C5:6E:80",
    "date": "2026-05-15T10:42:18Z",
    "content": "https://example.com/menu"
  }'

-u フラグは、設定でHTTP Basic認証を構成した時にNFC.coolが送るものに対応します - ユーザー名とパスワードはiOS Keychainに暗号化保存されます。

ループ全体を端から端まで見る一番速い方法: github.com/NickAtGit/nfc-cool-webhook-server。NFC.coolのWebhookペイロードを受信し、ログを出し、構造をライブで表示する最小限のサンプルサーバー。クローンして起動し、iPhoneを向ければ、スキャンが届くのが見えます。