Ana içeriğe geç

JSON Şemasının Tanımı

Bu belgede Entegrasyon modülünün JSON şemasının yapısı açıklanmaktadır.

Genel Yapı​

JSON şeması, her bir nesnenin ya bir düğüm (node) ya da bir sekme (tab) olduğu bir nesne dizisini temsil eder:

[
  {
    "label": "Merhaba Dünya!",
    "id": "1f24387b252057fe",
    "type": "tab",
    "disabled": false
  },
  {
    "name": "çalıştır",
    "id": "b51ab819b83e1915",
    "type": "inject",
    "x": 46.96875,
    "y": 99.51171875,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "bd07e1ff0aedba0b"
      ]
    ]
  },
  {
    "id": "2b524ca59e4ed633",
    "type": "debug",
    "name": "hata ayıklama",
    "x": 610.05078125,
    "y": 98.59765625,
    "z": "1f24387b252057fe",
    "wires": []
  },
  {
    "name": "fonksiyon",
    "func": "msg.payload = 'Dünya'\n\nreturn msg;",
    "id": "bd07e1ff0aedba0b",
    "type": "function",
    "x": 229.62890625,
    "y": 98.8515625,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "2e1172b330c69aeb"
      ]
    ]
  },
  {
    "id": "2e1172b330c69aeb",
    "type": "template",
    "name": "şablon",
    "x": 418.66796875,
    "y": 98.19140625,
    "z": "1f24387b252057fe",
    "syntax": "mustache",
    "template": "Merhaba {{payload}} !",
    "output": "str",
    "wires": [
      [
        "2b524ca59e4ed633"
      ]
    ]
  }
]

Düğümlerin Temel Parametreleri​

Çoğu düğüm aşağıdaki ortak parametrelere sahiptir:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğümün türü (örneğin, "inject", "function", "template")
  • name (string) - düğümün görüntülenen adı
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışın bağlı olduğu düğümlerin tanımlayıcılarının dizisi

Sistem Düğümleri​

"tab" Düğümü (sekme)​

tab türündeki düğüm, bir grup düğüm için bir konteynerdir ve arayüzde sekme olarak görsel olarak gösterilir.

Parametreler:

  • label (string) - sekmenin görüntülenen adı
  • id (string) - sekmenin benzersiz tanımlayıcısı
  • type (string) - düğüm türü (tab)
  • disabled (boolean) - sekmenin devre dışı olup olmadığı

"debug" Düğümü (hata ayıklama)​

debug türündeki düğüm, hata ayıklama paneline mesajlar göndermek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (debug)
  • name (string) - düğümün görüntülenen adı
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

Düğümler Arasındaki Bağlantılar​

wires parametresi, düğümler arasındaki bağlantıları tanımlar. Dizi içindeki her bir eleman, bir düğümün çıkışına karşılık gelir ve bu çıkışa bağlı olan düğümlerin tanımlayıcılarının dizisini içerir.

Örnek:

"wires": [
  [
    "bd07e1ff0aedba0b"
  ]
]

Düğüm Parametrelerinin Tanımı​

"inject" Düğümü (enjektör)​

inject düğümü, mesajları manuel olarak oluşturmak ve akışa göndermek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (inject)
  • name (string) - düğümün görüntülenen adı
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"function" Düğümü (fonksiyon)​

function türündeki düğüm, rastgele JavaScript kodu çalıştırmaya olanak tanır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (function)
  • name (string) - düğümün adı
  • func (string) - çalıştırılacak kod
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"template" Düğümü (şablon)​

template türündeki düğüm, mesajları şablonlar kullanarak dönüştürmek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (template)
  • name (string) - düğümün adı
  • syntax (string) - şablonun sözdizimi (mustache veya plain)
  • template (string) - mesaj şablonu
  • output (string) - çıktı türü (str — düz metin, json veya yaml)
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"interval-node" Düğümü (aralık)​

interval-node türündeki düğüm, belirli zaman aralıklarıyla mesajlar üretmek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (interval-node)
  • name (string) - düğümün adı
  • interval (number) - mesajlar arasındaki dakika cinsinden aralık
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"switch" Düğümü (anahtar)​

switch türündeki düğüm, mesajları koşullara bağlı olarak farklı yollarla yönlendirmek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (switch)
  • name (string) - düğümün adı
  • property (string) - kontrol edilecek mesaj özelliği
  • rules (array) - yönlendirme kurallarının dizisi
  • outputs (number) - çıkış portlarının sayısı
  • checkall (string) - tüm kuralları kontrol et (true veya false)
  • repair (boolean) - geçersiz mesajları düzelt
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"split" Düğümü (bölücü)​

split türündeki düğüm, mesajları birden fazla parçaya ayırmak için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (split)
  • name (string) - düğümün adı
  • property (string) - bölünecek mesaj özelliği
  • propertyType (string) - özellik türü (msg, flow, global)
  • splt (string) - dizeler için ayırıcı
  • spltType (string) - ayırıcı türü (str, bin)
  • arraySplt (number) - diziler için parça boyutu
  • arraySpltType (string) - dizilerin bölünme türü (len, index)
  • stream (boolean) - akış modu işleme
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"http in" Düğümü (HTTP girişi)​

http in türündeki düğüm, HTTP endpoint'leri oluşturmak ve gelen HTTP isteklerini almak için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (http in)
  • name (string) - düğümün adı (isteğe bağlı)
  • url (string) - endpoint'in URL yolu
  • method (string) - HTTP metodu (get, post, put, delete, patch)
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - istekleri işlemek için bağlantılar dizisi

"http request" Düğümü (HTTP isteği)​

http request türündeki düğüm, çıkış HTTP isteklerini gerçekleştirmek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (http request)
  • name (string) - düğümün adı
  • url (string) - istek için URL adresi
  • method (string) - HTTP metodu (GET, POST, PUT, DELETE, vb.)
  • ret (string) - yanıt formatı (obj, txt, bin)
  • headers (array) - istek başlıklarının dizisi
  • paytoqs (string) - yükü nereye yerleştireceği (body, query)
  • useAuth (boolean) - kimlik doğrulama kullan
  • authType (string) - kimlik doğrulama türü (basic, bearer)
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - yanıtı işlemek için bağlantılar dizisi

"http response" Düğümü (HTTP yanıtı)​

http response türündeki düğüm, istemciye HTTP yanıtları göndermek için kullanılır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (http response)
  • name (string) - düğümün adı
  • statusCode (number) - yanıtın HTTP durum kodu
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - bağlantılar dizisi (genellikle boştur)

"cms-events" Düğümü​

Bu düğüm, Events modülünden olayları izlemeye ve bunları akışa atmaya olanak tanır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (cms-events)
  • name (string) - düğümün adı
  • eventMarker (string) - olayın tanımlayıcısı
  • property (string) - işlenecek mesaj özelliği
  • targetType (string) - işleme hedefinin türü (msg, flow, global)
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - daha fazla işleme için bağlantılar dizisi

"admin-api" Düğümü (Admin API)​

Bu düğüm, çeşitli API'lerle etkileşimde bulunmayı sağlar.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (admin-api)
  • name (string) - düğümün adı
  • path (string) - API endpoint'inin yolu
  • method (string) - HTTP metodu (post, get, put, delete)
  • operation (string) - işlem tanımlayıcısı
  • data (string) - JSON formatında istek verileri
  • wires (array) - yanıtı işlemek için bağlantılar dizisi

"telegram" Düğümü​

telegram türündeki düğüm, Telegram Bot API aracılığıyla mesajlar gönderir. Alanlar hakkında ayrıntılı bilgi telegram düğüm sayfasında bulunmaktadır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (telegram)
  • name (string) - düğümün adı
  • botToken (string) - botun tokeni
  • chatId (string) - sohbetin tanımlayıcısı
  • text (string) - mesaj metni
  • parseMode (string) - metin formatı (none, Markdown, MarkdownV2 veya HTML)
  • replyMarkup (array) - Inline butonların dizileri, her butonun text ve callbackData'sı vardır
  • callbackQueryId (string) - callback isteğinin tanımlayıcısı
  • showAlert (boolean) - modal pencerede bildirim göster
  • notificationText (string) - bildirim metni (eğer showAlert: true ise)
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"whatsapp" Düğümü​

whatsapp türündeki düğüm, WhatsApp Business Cloud API aracılığıyla mesajlar gönderir. Alanlar hakkında ayrıntılı bilgi whatsapp düğüm sayfasında bulunmaktadır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (whatsapp)
  • name (string) - düğümün adı
  • phoneNumberId (string) - gönderici numarasının tanımlayıcısı
  • accessToken (string) - erişim tokeni
  • apiVersion (string) - Graph API versiyonu (varsayılan v20.0)
  • action (string) - mesaj türü (message veya template)
  • to (string) - alıcının numarası
  • text (string) - mesaj metni (eğer action: message ise)
  • templateName (string) - şablon adı (eğer action: template ise)
  • locale (string) - şablonun dili (eğer action: template ise)
  • components (array) - şablon parametreleri, her birinin type (header veya body), parameter_name ve text'i vardır
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi

"notification" Düğümü​

notification türündeki düğüm, Events modülünden bir olay şablonuna göre bildirim gönderir. Alanlar hakkında ayrıntılı bilgi notification düğüm sayfasında bulunmaktadır.

Temel Parametreler:

  • id (string) - düğümün benzersiz tanımlayıcısı
  • type (string) - düğüm türü (notification)
  • name (string) - düğümün adı
  • eventId (number | null) - olay şablonunun tanımlayıcısı
  • variables (object) - şablonun işaretçilerine göre değişken değerleri
  • recipientsPath (string) - mesajdaki alıcılar dizisine giden yol
  • x, y (number) - düğümün çalışma alanındaki koordinatları
  • z (string) - düğümün ait olduğu sekmenin tanımlayıcısı
  • wires (array) - çıkışlar için bağlantılar dizisi