Referans

Sözlük

Uygulamanın kullandığı sözcükler ve her birinin tam anlamı.

Uygulama ya da bu belgeler bu sözcükleri kullandığında kastedilen tam olarak şudur.

Sistemin yapısı

Terim	Anlamı
Merkez	Bu uygulama — cihazlarınızın bağlı olduğu ağlar ile verilerini kullanan sistemler arasındaki nokta.
Sol taraf	Cihazların yaşadığı ve mesajların geldiği yer: bir Sigfox arka ucu, bir ChirpStack veya TTN sunucusu.
Sağ taraf	Veriyi kullanan sistem — bir faturalama platformu, bir HTTP uç noktası.
Kaynak (sol)	Yönü Kaynak (sol) olan entegrasyon.
Hedef (sağ)	Yönü Hedef (sağ) olan entegrasyon.
Sağlayıcı	Bir entegrasyonun ardındaki somut sistem türü: `SIGFOX`, `CHIRPSTACK`, `TTN`, `UNA_SU`, `HTTP`, `GENERIC`.
Adaptör	Merkez'in bir sağlayıcının dilini konuşan parçası — callback'lerini doğrular ya da onun biçiminde iletir. Bir ağ eklemenin geliştirme değil yapılandırma olmasının sebebi.
Entegrasyon	Başka bir sisteme yapılandırılmış bağlantı: sağlayıcı, yön, kimlik bilgileri ve ayarlar.

Terim	Anlamı
Kiracı	Bir kurum. Kiracılar iç içe geçer — operatör, bayi, son müşteri — ve her biri kendini ve altındaki her şeyi görür.
Aktif kiracı	O an içinde çalıştığınız, kenar çubuğundan seçilen kiracı. Ne göreceğinize ve yeni kayıtların nereye düşeceğine karar verir.
Proje	Bir kiracı içindeki dağıtım. Cihazlar, entegrasyonlar, yönlendirmeler ve kurallar tam olarak birine aittir.

Terim	Anlamı
Cihaz	Tek bir fiziksel nesne; kaç ağda konuşursa konuşsun bir kez oluşturulur.
Teknoloji bağlaması	Bir ağın cihaz için kimliği — Sigfox cihaz ID ve PAC, LoRaWAN DevEUI ve anahtarlar. Bir cihazda birden çok olabilir.
Cihaz profili	Bir cihaz modeli: üretici, model, ünitelerinin ihtiyaç duyduğu alanlar ve konuştuğu her radyo için çözücü. O modeldeki her cihaz paylaşır.
Alan şeması	Bir profildeki cihazın hangi anahtarları doldurması gerektiği veya doldurabileceği ve her birinin düz öznitelik mi şifreli gizli bilgi mi olduğu.
Çözücü	Yük baytlarını adlandırılmış ölçümlere dönüştürür. Gramer (bildirimsel), JavaScript (sandbox'lı) veya yok.
telemetry / meta	Bir çözücünün döndürdüğü iki grup — cihazın ölçtüğü ve iletimle ilgili olan. Hedefinize kadar ayrı kalır.

Terim	Anlamı
Mesaj	Normalleştirilmiş tek bir gelen yük. Geçicidir — iletilene kadar tutulur, sonra silinir.
İletim	Bir mesajı bir hedefe ulaştırma girişimi. Üç hedefe giden bir mesaj, üç iletimdir.
Idempotency anahtarı	Gelen mesaj başına sabit bir anahtar; tarafınızın tekrarı tanıması için. Merkez en az bir kez iletir.
Ölü mektup	Sekiz denemesini tüketmiş bir iletim. İncelenmek ve yeniden gönderilmek üzere park eder, kaybolmaz.
Yeniden gönderim	Ölü mektuptaki bir iletimi yeniden kuyruğa alma. Güncel yapılandırmayla yeniden kurulur; "düzelt, sonra yeniden gönder"in çalışmasının sebebi budur.

Terim	Anlamı
Yönlendirme	Bir kaynak ile bir hedef arasındaki kablo. Hiçbiri tanımlı değilse proje her aktif hedefe yayın yapar.
Kural	İletimden önce yukarıdan aşağıya değerlendirilen bir koşul ve bir eylem — ilet, at, downlink ile yanıtla veya bekle ve ilişkilendir.
Çıktı yapısı	Bir hedefe iletilen biçim; kaynak → hedef çifti başına ayarlanır. Tam mesaj, ham sağlayıcı çerçevesi, yalnızca çözülmüş telemetri, her şey çözülmüş veya özel.
Downlink	Cihaza geri giden yanıt; uplink'ini taşıyan callback'in cevabında iletilir.

Terim	Anlamı
Uç nokta	Bir ağın mesajları POST ettiği adres. Merkez belirteci yoktur — yükü kaynağın adaptörü doğrular.
Uç nokta anahtarı	Bir uç noktayı adresleyen anlamsız belirteç: proje için `pk_`, kaynak için `sk_`, cihaz için `dk_`. Tahmin edilemez ve döndürülebilir — ama kimlik doğrulaması değil, kapsam belirleyicidir.
Kısa ad (slug)	İsteğe bağlı okunabilir takma ad — proje için `…/i/<ad>`, kaynak için `…/i/s/<ad>`. Tasarım gereği tahmin edilebilir; yükü yine adaptör doğrular.

Terim	Anlamı
Sağlama	Merkez'in kaydına uyacak şekilde sağlayıcıda bir cihaz, cihaz tipi veya callback oluşturmak ya da güncellemek.
Plan / Uygula	Gönderilecek isteği tam olarak gösteren kuru çalışma ve gerçeği. Uygula kapatılabilir ve idempotenttir — yeniden çalıştırmak çoğaltmaz, uzlaştırır.
Sözleşme	Sigfox'ta bir cihaz tipinin neye izinli olduğu — downlink taşıyıp taşıyamayacağı dâhil. Cihaz tipi oluşturulurken sabitlenir.

Sağlayıcı kimlik bilgileri

Bir API kimlik bilgisini bir kez saklayın, her yerde kullanın, tek yerden döndürün.

Hata kodları

Hata zarfı, her kodun anlamı ve ne yapmanız gerektiği.