ビルダーのために

NFC.coolはどこへ接続できるか

WebhookはJSONのPOSTを指定URLへ送るだけ - HTTPを話すものなら何でも繋げられます。

よくあるワークフロー・パターン

• 在庫管理 + 監査トレイル。 商品のタグをタップ → NFC.coolがスプレッドシートや倉庫システムへPOST → タイムスタンプ、タグ識別子、ペイロード付きの行が追加。

• イベントでのリード収集。 ブースのバナーにあるタグをタップ → CRMがフォローアップメールを自動送信。

• スマートホーム・トリガー。 玄関のタグをタップして「帰宅した」を記録 → Home Assistant / Homey / HubitatがWebhook経由で受信。

• 資産トラッキング。 メンテナンス担当者が機器のタグをタップして点検を記録 → バックエンドがコンプライアンス・ログを構築。

• カンファレンスのチェックイン。 参加者のNFCバッジをタップ → イベント・プラットフォームがリアルタイムで更新。

Webhook

アプリ内の 設定 → Webhook で有効化できます:HTTPSのURLを1つ入力し、必要に応じてHTTP Basic認証用のユーザー名/パスワードを設定、続いて「NFCスキャン」と「QR & バーコードスキャン」を個別にオン/オフできます。iOSとAndroidで利用可能。

各スキャンにつき、設定したURLへ単一のPOSTが送信されます。専用のリトライ・キューはありません:エンドポイントに到達できない、または2xx以外のレスポンスが返ると、そのPOSTは失敗扱いになります。成功時は204 No Contentを返すのが理想です(2xxはすべて受け取り成功として扱います)。

Webhookペイロード

Content-Typeはapplication/json、ボディは整形済みJSONです:

{
  "identifier" : "04:A2:7F:1B:5E:80:00",
  "date" : "2026-05-12T14:23:01Z",
  "content" : "https://example.com/check-in/abc123"
}

構造化タグ(現状はOpenPrintTag)では、さらに2つのフィールドが追加されます:

{
  "identifier" : "04:A2:7F:1B:5E:80:00",
  "date" : "2026-05-12T14:23:01Z",
  "content" : "Filament Spool #1234",
  "tagType" : "openPrintTag",
  "structured" : { "...パース済みフィールド..." }
}

フィールド・リファレンス:

• identifier - NFCスキャンでは、タグのハードウェアUIDをコロン区切りの大文字16進数で表現したもの(例:04:A2:7F:1B:5E:80:00)。タグごとに安定しているため、重複排除に使えます。一方、QR・バーコードスキャンではスキャンごとに新しいUUIDが発行されるため、コードに紐づく安定した識別子ではありません。古いiOSのNFC互換モードでUIDが取得できない場合は、文字列NoIdentifierInCompatibilityModeが入ります。

• date - ISO 8601形式。デバイス上でスキャンが発生した時刻。

• content - デコード済みの内容。NFCの場合はNDEFレコードの値(URIまたはテキスト)、QR/バーコードの場合は生のデコード文字列。

• tagType - 通常のスキャンでは省略されます。OpenPrintTagの場合は"openPrintTag"。

• structured - 通常のスキャンでは省略されます。tagTypeがある場合、パース済みの構造化ペイロード。

認証

Webhookは HTTP Basic認証のみ をサポートします。設定 → Webhook で、ユーザー名とパスワードをiOSキーチェーンに保存できます(任意)。これらの値を使い、サーバーからの401 / WWW-Authenticate: Basicチャレンジに応答します。

つまり、認証の要否はあなたのエンドポイント次第です。不要なら、アプリ側のユーザー名/パスワードを空にし、サーバー側でもチャレンジを発行しなければOK。必要なら、最初のPOSTに対して401とWWW-Authenticate: Basic realm="…"を返してください - デバイスは保存した認証情報をAuthorization: Basic …としてリトライします。すべてTLSで送られ、NFC.coolのサーバーが認証情報を見ることはありません。

Bearerトークン、APIキー、HMAC署名は現状サポートしていません。必要な場合は、Cloudflare Workerやnginxなどのリバースプロキシでこれらの方式をBasic認証に変換してください。

レシーバー例

cURL - クイック・スモークテスト

curl -X POST https://your-server.example/webhook \
  -u 'nfc-cool:your-password' \
  -H 'Content-Type: application/json' \
  -d '{"identifier":"04:A2:7F:1B:5E:80:00","date":"2026-05-12T14:00:00Z","content":"hello"}'

Node.js - Expressレシーバー

import express from "express";
import basicAuth from "express-basic-auth";

const app = express();
app.use(express.json());

app.post(
  "/webhook",
  basicAuth({
    users: { "nfc-cool": process.env.WEBHOOK_PASSWORD },
    challenge: true, // NFC.coolが認証情報付きで再送するよう促す
  }),
  (req, res) => {
    const { identifier, date, content, tagType } = req.body;
    console.log(`scan ${tagType ?? "plain"} ${content} id=${identifier} at ${date}`);
    res.status(204).end();
  }
);

app.listen(3000);

Python - FastAPIレシーバー

import os
import secrets
from fastapi import FastAPI, Depends, HTTPException, Request, status
from fastapi.security import HTTPBasic, HTTPBasicCredentials

app = FastAPI()
security = HTTPBasic()

def check(creds: HTTPBasicCredentials = Depends(security)):
    ok_user = secrets.compare_digest(creds.username, "nfc-cool")
    ok_pass = secrets.compare_digest(creds.password, os.environ["WEBHOOK_PASSWORD"])
    if not (ok_user and ok_pass):
        raise HTTPException(
            status.HTTP_401_UNAUTHORIZED,
            headers={"WWW-Authenticate": 'Basic realm="nfc-cool"'},
        )

@app.post("/webhook")
async def webhook(request: Request, _: None = Depends(check)):
    body = await request.json()
    print(f"scan: {body['content']} id={body['identifier']}")
    return {"status": "ok"}

App Intents & ショートカット

NFC.cool Tools(iOS)は、ショートカット・アプリ、オートメーション、集中モード、Apple Intelligenceに組み込めるApp Intentsをいくつか用意しています。

iOS 18向けの専用バリアント(NFC Scan、QR Scan、Document Scan、Object Scan、Room Scan)は、Spotlightやアクションボタンのピッカーに直接表示されます。

URLスキーム

他のiOSアプリ、ウィジェット、ホーム画面のショートカットからのディープリンク用に、NFC.cool Toolsは以下のURLを登録しています:

nfcforiphone://scan-nfc
nfcforiphone://scan-code
nfcforiphone://scan-document
nfcforiphone://scan-object       (iOS 17+)
nfcforiphone://scan-room         (iOS 17+)

いずれを開いても、対応するスキャナーが直接立ち上がります。nfc://とgeo://スキームも登録されており、外部のタグ/座標リンクの受け渡しに対応します。

機械可読リソース

ツール、検索エンジン、AIエージェント向けに発見可能なフィード:

NFC.coolの上に何か作っていますか?ここに掲載すべきインテグレーション・パートナーをご存知ですか?hello@nfc.coolまでご連絡ください。