Webhook (kendi adresine POST)
Tarama başarılı olduğu anda yapılandırılmış JSON gövdesiyle HTTP POST. Tek adres, istersen HTTP Basic kimlik doğrulaması, hepsi bu. iOS ve Android.
Webhook ve Otomasyon
iOSAndroidNFC tag, QR kod ya da barkod okuttuğun anda beş yerleşik kanca çalışır: kendi sunucuna POST at, adresi aç, kısayol çalıştır, sonucu sesli okut ya da ses çal. Tarayıcı NFC.cool, eylem senin.
Beş kanca
Kısayol (iOS)
Okunan adres `shortcuts://` şemasını taşıyorsa eşleşen iOS kısayolu kendiliğinden çalışır, fazladan dokunmaya gerek kalmaz. Tarama verisini Kısayollar'ın ulaşabildiği her yere yönlendir.
Bağlantıyı aç (iOS)
İçerik normal bir adresse Safari'de (ya da eşleşen uygulamada) kendiliğinden açılır. "Açmak için dokun" adımını atla.
Konuşma sentezi (iOS)
Okunan içeriği eller serbest sesli dinle. Konuşma hızı ayarlanabilir. Erişilebilirlikte, elin doluyken ya da sırf tatmin edici bir onay için işe yarar.
Ses çal (iOS)
Okuma anında onay sesi çal: kendi seçtiğin ses dosyası ya da hazır tonlardan biri.
Webhook nasıl çalışır
Tetikleyiciler: NFC, QR ve barkod
iOSAndroidWebhook'lar üç olay kaynağında çalışır: NFC okumaları, QR taramaları ve barkod taramaları. Her kaynağın kendi açma kapama anahtarı var, yani kamera tarayıcısı aynı uç noktayı doldurmadan NFC okumalarını stok sistemine aktarabilirsin. Webhook'un kendisi aynı kalır: tek adres, tek JSON yükü, tek POST.
Yükün biçimi
iOSAndroidHer POST şu biçimde bir JSON gövdesi gönderir:
{
"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 ve structured yalnızca OpenPrintTag gibi özel biçimlerde görünür; diğer tüm taramalar yalnızca ilk üç alanı gönderir. Alan alan dökümü, kimlik doğrulamayı, curl örneklerini ve çalışmaya hazır örnek sunucuları geliştirici belgelerinde bulabilirsin.
GitHub'da örnek sunucu
iOSAndroidDöngünün tamamını uçtan uca görmenin en hızlı yolu: GitHub'daki web sunucusu. NFC.cool webhook yüklerini kabul eden, kaydeden ve yapıyı canlı gösteren küçük bir örnek sunucu. Klonla, çalıştır, iPhone'unu ona yönlendir, taramaların düştüğünü izle.
Teknik ayrıntılar
Aktarım
- HTTPS önerilir; geliştirmede HTTP'ye izin verilir
- `Content-Type: application/json` ile POST
- İsteğe bağlı HTTP Basic kimlik doğrulaması (kullanıcı adı ve parola)
- Kimlik bilgileri iOS Anahtar Zinciri'nde şifreli saklanır
Yük
- `identifier` - tag UID'si ya da okunan kod
- `date` - ISO 8601 zaman damgası
- `content` - çözülmüş içerik (adres, metin ve benzeri)
- `tagType` - yapılandırılmış tag'lerde bulunur (örneğin `openPrintTag`)
- `structured` - yapılandırılmış tag türleri için iç içe JSON
Kaynaklar
- NFC okumaları (NDEF)
- QR taramaları
- Barkod taramaları
- Her kaynak ayrı ayrı açılabilir
Ücretsiz ve Platinum
| Ücretsiz | Platinum | |
|---|---|---|
| NFC ve QR webhook | ✗ | ✓ |
| Konuşma sentezleyici | ✗ | ✓ |
| Kısayollar | ✗ | ✓ |
| iCloud eşitleme | ✓ | ✓ |
Sık sorulanlar
Bu Android'de çalışıyor mu?
Evet, webhook'lar NFC.cool Tools'un hem iOS hem Android sürümünde var. JSON yükünün biçimi iki platformda da aynı. (Diğer dört kanca (otomatik kısayol, konuşma, ses ve bağlantı açma) yalnızca iOS'ta.)
Kaç adres tanımlayabilirim?
Bugün için tek adres. Tüm tarama olayları aynı adrese gider; hangi kaynağın açık olduğuna ve yükün türüne göre ayırt edilir.
Hangi kimlik doğrulama destekleniyor?
HTTP Basic: kullanıcı adı ve parola, iOS Anahtar Zinciri'nde şifreli saklanır. Bearer token, özel başlıklar ve HMAC imzalama şimdilik desteklenmiyor.
Sunucum kapalıysa ne olur?
POST başarısız olur ve olay cihazda kaydedilir. Bugün otomatik yeniden deneme kuyruğu yok; sunucun kesintiye uğrayabiliyorsa işleyicini tekrar çağrılmaya dayanıklı yaz ve tarama geçmişinden yeniden tetikle.
Yük boyutu sınırı var mı?
NFC.cool tarafında katı bir sınır yok. Tag içeriklerinin kendisi NFC standardıyla sınırlı (tipik NDEF tag'lerde birkaç KB).
Gerçekten çalışırken nerede görebilirim?
GitHub'daki web sunucusunu klonla, yerelde çalıştır, uygulamayı ona yönlendir; her taramanın anında geldiğini göreceksin.
Taramaya hazır mısın?
★4,5·73.500 değerlendirme·Ücretsiz