Bir kaynak bağlayın
Kaynak, mesajların geldiği yerdir. Bir kaynak bağlamak, entegrasyonu oluşturmak ve ardından ağı ortaya çıkan uç noktaya yönlendirmek demektir.
Entegrasyonu oluşturun
Entegrasyonlar → Yeni entegrasyon, yön Kaynak (sol), sağlayıcıyı seçin.
Sağlayıcı geri arama için kimlik doğrulaması istiyorsa bir kimlik bilgisi
bağlayın — bkz.
Sağlayıcı kimlik bilgileri.
Bir uç nokta seçin
Merkez birden fazla adres verir ve bunlar neyi sabitlediklerine göre farklılaşır. Hepsi aynı yükleri kabul eder.
| Uç nokta | Sabitlediği | Ne zaman |
|---|---|---|
…/ingest/source/{sk_key} | tam olarak bu kaynak | Normal durum. Tahmin yok. |
…/ingest/project/{pk_key} | proje | Birkaç kaynak için tek adres; Merkez hangisi olduğunu çıkarır. |
…/ingest/device/{dk_key} | tek bir cihaz | Gönderen tek bir cihaz adına konuşuyor ve kimliğini yazmıyorsa. |
…/webhooks/{integrationId} | tam olarak bu kaynak | Özgün biçim; anahtarlı adresler genelde daha kullanışlıdır. |
Adresi entegrasyon listesinden veya Akış → Uç nokta ve şema'dan kopyalayın.
Okunabilir adresler
Anlamsız bir sk_7f3a… anahtarı bir makine için uygundur, bir e-postada
zahmetlidir. Bir kısa ad (slug) tanımlarsanız kısa bir bağlantı alırsınız:
https://merkeziniz/i/baylan-hatay-proje1 ← proje kısa adı
https://merkeziniz/i/s/sigfox-hatay-bidir ← kaynak kısa adı
Kısa adlar küçük harf, rakam ve tireden oluşur ve en az altı karakterdir. Proje ve kaynak kısa adları bağımsız alanlardır; aynı sözcük ikisinde de kullanılabilir.
Kısa adlar tasarım gereği tahmin edilebilirdir — amaçları budur. Varsayılan olarak kapalıdırlar ve güvenlik açısından hiçbir şeyi değiştirmezler: yükü yine adaptör doğrular. Anahtarlı adres, kısa adın yanında çalışmaya devam eder.
Nerede: Akış → Uç nokta ve şema, ya da entegrasyon.
Güvenceye alın
Paylaşılan gizli anahtar
Çoğu sağlayıcı her geri aramada bir gizli anahtar gönderebilir ve adaptör bunu denetler. Entegrasyonda tanımlayın, aynı değeri ağın callback ayarında da tanımlayın. Asıl kimlik doğrulaması budur.
Zorunlu başlıklar
Bir kaynak, her gelen istekte belirli başlıkları zorunlu kılabilir. Bir başlığı zorunlu işaretlerseniz, onu taşımayan istekler başka hiçbir şey olmadan önce reddedilir.
Yükün önünde ikinci bir katman olarak ya da zaten bir yönlendirme başlığı isteyen bir ağ geçidini karşılamak için kullanışlıdır. Zorunlu olmayanlar yalnızca gösterim amaçlıdır — göndereni yapılandıran kişinin ne göndereceğini bilmesi için uç noktanın yanında listelenir.
Anahtar döndürme
Döndür, yeni bir uç nokta anahtarı verir ve eskisini anında geçersiz kılar. Geçiş süresi yoktur; önceki adrese POST etmeye devam eden her arka uç o anda başarısız olmaya başlar.
Bir anahtar fazla geniş paylaşıldıysa veya sızdıysa döndürün. Planlayın: tüm göndericileri aynı bakım aralığında güncelleyin.
Tanımlı bir kısa ad döndürmeden etkilenmez — kısa ad adresi çalışmaya devam eder, çünkü anahtara değil entegrasyona çözümlenir.
Yükü tanımlayın
Uç nokta ve şema ayrıca beklediğiniz yük biçimini kaydetmenizi sağlar. Bu, göndereni yapılandıran kişinin ne göndereceğini görmesi için uç noktanın yanında yayımlanır.
Belgelemedir, doğrulama değildir — Merkez mesajları buna uymadığı için reddetmez.
Ağı buraya yönlendirin
Son olarak sağlayıcı tarafındaki callback'i yapılandırın. Sigfox'ta bu, cihaz tipinin callback'leri üzerindedir; Merkez bunları sizin için de kaydedebilir.
Bir test uplink'i gönderin, sonra Analitik'e bakın. Alınan arttıysa
bağlantı çalışıyor demektir.