Geliştirici Dokümantasyonu

NotusFlow API katmanı, güvenli mikroservis haberleşmesi için YARP reverse proxy arkasında hizmet vermektedir. API isteklerinde yetkilendirme işlemi JWT Bearer token veya yönetim panelinden üreteceğiniz API Key anahtarı ile sağlanır. Tüm veri transferleri `application/json` formatındadır.

# İş akışı şablonunu tetikleyerek yeni bir süreç başlatırcurl -X POST https://gateway.notusflow.com/api/workflow-execution/trigger \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "definitionId": "uuid-9876-5432-10", "variables": { "customerName": "Notussoft Yazılım", "budget": 75000 } }'

NotusFlow iş akışı motoru üzerinde tamamlanan veya kullanıcı onayı bekleyen görevleri dinlemek için webhook servislerimizi aktifleştirebilirsiniz. Bir süreç düğümü tamamlandığında, belirttiğiniz hedef adrese (endpoint) imzalı (SHA-256 HMAC) bir HTTP POST isteği gönderilir.

{
  "eventId": "evt-7738-990",
  "eventType": "workflow.completed",
  "timestamp": "2026-06-01T07:22:00Z",
  "workflowId": "uuid-9876-5432-10",
  "status": "Success",
  "variables": {
    "customerName": "Notussoft Yazılım",
    "approvedBudget": 75000,
    "aiAnalysisResult": "Approved"
  }
}

NotusFlow form elemanları ve iş akışı adımları, C# diliyle anlık çalışma zamanı (runtime) kod parçacıkları çalıştırmanıza olanak tanır. `ScriptingService` altyapısı bu kodları güvenli bir sandbox ortamında ve önceden derlenmiş delegeler (delegates caching) aracılığıyla yüksek performansla yürütür.

// Sipariş tutarına göre dinamik KDV ve iskonto doğrulaması yapardecimal subTotal = GetValue<decimal>("SiparişTutarı");string customerType = GetValue<string>("MüşteriTipi");decimal discount = 0m;if (customerType == "Premium" && subTotal > 50000m) { discount = subTotal * 0.15m; // Premium müşteriye %15 İskontoLog("Premium bütçe barajı aşıldı. %15 indirim uygulandı."); }else if (subTotal > 20000m) { discount = subTotal * 0.05m; // Standart indirim}decimal netTotal = subTotal - discount;decimal vatRate = 0.20m; // %20 KDVdecimal totalVat = netTotal * vatRate; SetValue("İndirimTutarı", discount); SetValue("KDVToplamı", totalVat); SetValue("GenelToplam", netTotal + totalVat);if (netTotal + totalVat > 100000m) { SetWarning("Süreç yüksek bütçeli! Satış Direktörü onayı otomatik eklendi."); }