Kavramlar

Entegrasyonlar

Kaynaklar, hedefler, sağlayıcılar ve bir adaptörün sizin için yaptığı iş.

Entegrasyon, başka bir sisteme kurulmuş yapılandırılmış bir bağlantıdır. Merkez'in konuştuğu her şey — hangi yönde olursa olsun — bir entegrasyondur.

Yön her şeyi belirler

Bir entegrasyon oluştururken bir yön seçersiniz ve bu sonradan anlamlı biçimde değiştirilemez; çünkü entegrasyonun ne olduğunu o belirler.

Kaynak (sol)
Mesajların geldiği yer. Bir Sigfox arka ucu, bir ChirpStack veya TTN sunucusu. O ağı yönlendireceğiniz bir uç nokta alır.
Hedef (sağ)
Mesajların gittiği yer. Faturalama platformunuz, bir HTTP uç noktası, Una Su. Bir çıktı yapısı ve bir iletim geçmişi alır.

Sağlayıcılar ve adaptörler

Sağlayıcı, somut sistem türüdür: SIGFOX, CHIRPSTACK, TTN, UNA_SU, HTTP veya GENERIC.

Her sağlayıcının bir adaptörü vardır — Merkez'in o sistemin dilini bilen parçası. Bir kaynak için adaptör gelen yükleri doğrular ve Merkez'in iç biçimine çevirir. Bir hedef için giden isteği nasıl doğrulayacağını ve başarılı bir iletimin neye benzediğini bilir.

Bir cihaz ağı eklemenin geliştirme değil yapılandırma olmasının sebebi budur: adaptör zaten vardır ve normalleştirmeden sonraki her şey sağlayıcıdan bağımsızdır.

GENERIC bir kaçış kapısıdır
Özel adaptörü olmayan bir sağlayıcıdan gelen kaynak, düz bir yük kabul eden GENERIC kullanabilir. Otomatik mesaj tipi işleme gibi sağlayıcıya özgü kolaylıkları kaybedersiniz, ama bir adaptör bekleyerek tıkanmazsınız.

Kimlik bilgileri ayrıdır

Bir entegrasyon API kullanıcısını ve parolasını doğrudan saklamaz. Kiracı düzeyinde tutulan bir kimlik bilgisine başvurur.

Bu ayrım bilinçlidir:

  • Tek bir Sigfox kimlik bilgisi, ona ihtiyaç duyan her entegrasyona hizmet eder. Parolayı döndürmek yirmi düzenleme değil, tek düzenlemedir.
  • Gizli bilgiler şifrelenerek saklanır ve kaydedildikten sonra geri döndürülmez.
  • Kimlik bilgileri kapsamlanabilir — varsayılan olarak kiracı geneli, ya da tek bir proje için geçersiz kılınmış.

Bkz. Sağlayıcı kimlik bilgileri.

Aktarımlar

Her kaynak bir webhook değildir. Bir entegrasyonun aktarımı şunlardan biri olabilir:

  • HTTP — ağ, uç noktanıza POST eder. Yaygın durum.
  • MQTT — Merkez bir broker konusuna abone olur.
  • TCP / CoAP — Merkez gelen çerçeveler için bir portu dinler.

HTTP kaynakları JSON, XML veya düz metin kabul eder; yani XML gönderen bir arka uç için önüne bir çeviri katmanı koymanız gerekmez.

Bağlantıyı test etme

Hedeflerin bir Test et düğmesi vardır; saklı ayarlarla gerçek bir bağlantı dener ve Bağlantı başarılı ya da Bağlantı başarısız der.

Kullanın. Yanlış bir adresi veya süresi dolmuş bir belirteci şimdi bulmak, bunu ölü mektup kuyruğundan öğrenmekten çok daha ucuzdur.

Global entegrasyonlar

Bir entegrasyon normalde bir projeye bağlıdır. Platform düzeyindeki bir kiracı, kiracılar arası şablon olarak global entegrasyonlar da oluşturabilir. Bunlar olağan proje dağıtımının dışında tutulur — kopyalanmak için vardırlar, sizin trafiğinizi almak için değil.

Sırada

Bir kaynak bağlayın
Uç noktalar, anahtarlar, kısa adlar, gizli anahtarlar ve zorunlu başlıklar.
Bir hedefe yönlendirin
Kaynakları hedeflere bağlayın ve yayını durdurun.
Copyright © 2026