webhook (إرسال POST إلى URL الخاص بك)
طلب HTTP POST مع جسم JSON منظّم لحظة نجاح المسح. اضبط URL واحدًا، ومصادقة HTTP Basic اختيارية، وانتهيت. iOS وAndroid.
الـwebhooks والأتمتة
iOSAndroidخمسة خطّافات مدمجة تنطلق لحظة مسحك لوسم NFC أو رمز QR أو باركود - أرسل POST إلى خادمك الخاص، أو افتح URL، أو شغّل اختصارًا، أو انطق النتيجة بصوت مسموع، أو شغّل صوتًا. NFC.cool هو الماسح؛ وأنت تملك الإجراء.
الخطّافات الخمسة
الاختصار (iOS)
عندما يحمل URL ممسوح مخطط `shortcuts://`، شغّل اختصار iOS المطابق تلقائيًا - دون لمسة إضافية. مرّر بيانات المسح إلى أي شيء يمكن للاختصارات الوصول إليه.
فتح الروابط (iOS)
عندما تكون الحمولة عبارة عن URL عادي، افتحه تلقائيًا في Safari (أو هدف الرابط العميق المطابق). تجاوز خطوة 'اللمس للفتح'.
تركيب الكلام (iOS)
اقرأ الحمولة الممسوحة بصوت مسموع، دون استخدام اليدين. معدّل نطق قابل للضبط. مفيد لإمكانية الوصول، أو سير العمل حين تكون يداك مشغولتين، أو لمجرد تأكيد مُرضٍ.
تشغيل الصوت (iOS)
شغّل صوت تأكيد عند المسح - ملف صوتي من اختيارك أو إحدى النغمات المدمجة.
كيف يعمل الـwebhook
المُشغّلات - NFC وQR والباركود
iOSAndroidتنطلق الـwebhooks عند ثلاثة مصادر أحداث: عمليات مسح NFC، وعمليات مسح QR، وعمليات مسح الباركود. لكل مصدر مفتاح تفعيل/تعطيل خاص به، بحيث يمكنك تمرير قراءات NFC إلى نظام المخزون لديك دون أن يُغرق ماسح الكاميرا نقطة النهاية نفسها. الـwebhook نفسه واحد - URL واحد، وحمولة 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. خادم مثال بسيط يقبل حمولات webhook الخاصة بـNFC.cool، ويسجّلها، ويعرض البنية مباشرةً. استنسخه، وشغّله، ووجّه جهاز iPhone نحوه، وشاهد عمليات المسح تصل.
التفاصيل التقنية
النقل
- يُنصح باستخدام HTTPS؛ ويُسمح بـHTTP في بيئة التطوير
- طلب POST مع `Content-Type: application/json`
- مصادقة HTTP Basic اختيارية (اسم المستخدم + كلمة المرور)
- بيانات الاعتماد مخزّنة مشفّرة في iOS Keychain
الحمولة
- `identifier` - معرّف UID للوسم أو الرمز الممسوح
- `date` - طابع زمني بصيغة ISO 8601
- `content` - الحمولة المفكوكة (سلسلة URL أو نص، إلخ)
- `tagType` - موجود للوسوم المنظّمة (مثل `openPrintTag`)
- `structured` - كائن JSON متداخل لأنواع الوسوم المنظّمة
المصادر
- عمليات مسح NFC (قراءات NDEF)
- عمليات مسح QR
- عمليات مسح الباركود
- كل مصدر قابل للتفعيل بشكل مستقل
المجاني مقابل Platinum
| Free | Platinum | |
|---|---|---|
| webhook لـNFC وQR | ✗ | ✓ |
| مُركّب الكلام | ✗ | ✓ |
| الاختصارات | ✗ | ✓ |
| مزامنة iCloud | ✓ | ✓ |
الأسئلة الشائعة
هل يعمل هذا على Android؟
نعم - الـwebhooks متوفّرة على نسختي iOS وAndroid من NFC.cool Tools. شكل حمولة JSON نفسه عبر المنصّات. (الخطّافات الأربعة الأخرى في iOS - الاختصار التلقائي، والنطق، والصوت، وفتح الروابط - حصرية لـiOS.)
كم عدد عناوين URL التي يمكنني ضبطها؟
URL واحد اليوم. يستقبل الـURL نفسه جميع أحداث المسح، ويُميَّز بينها عبر مفاتيح المصادر المُفعّلة ونوع الحمولة.
ما نوع المصادقة المدعوم؟
مصادقة HTTP Basic - اسم المستخدم + كلمة المرور، مخزّنة مشفّرة في iOS Keychain. أما رموز Bearer، والترويسات المخصّصة، وتوقيع HMAC فغير مدعومة حاليًا.
ماذا يحدث إذا كان خادمي غير متصل؟
يفشل طلب POST ويُسجَّل الحدث على الجهاز. لا يوجد اليوم طابور إعادة محاولة تلقائي؛ فإذا كان خادمك عرضة للتذبذب، فصمّم معالجك ليكون آمنًا عند التكرار (idempotent)، وأعد إطلاقه من سجل عمليات المسح.
هل هناك حد لحجم الحمولة؟
لا حد صارم يفرضه NFC.cool. حمولات الوسوم نفسها محدودة بمعيار NFC (بضعة كيلوبايت للوسوم NDEF النموذجية).
أين يمكنني رؤيته يعمل فعليًا؟
استنسخ خادم الويب على GitHub، وشغّله محليًا، ووجّه التطبيق نحوه، وسترى كل عملية مسح تصل في الوقت الفعلي.
جاهز للمسح؟