Skip to main content

Async / Sync Yöntemi

Instance veya transition çalıştırma istekleri sync query parameter'ı alır. Bu parametre, çalışma biçimini ve client'a dönen response'un içeriğini değiştirir.

sync=true — Senkron​

İstek senkron çalışır:

  • vNext işlemi tamamlanana kadar bekler
  • Response'da işlem sonucu veri ile birlikte döner
  • Client tek bir HTTP çağrısı ile sonucu alır
  • Long-running işlemler için timeout riski vardır

Örnek:

POST /api/v1/{domain}/workflows/{wf}/instances/start?sync=true

Response: instance ID + güncel state + tüm output data.

sync=false (default) — Asenkron​

İstek asenkron çalışır:

  • vNext sadece isteği kabul eder ve hemen response döner
  • Response'da id ve status bilgisi vardır
  • İşlem arka planda işlenir
  • Client sonucu öğrenmek için State Function üzerinden long-polling yapar

Örnek:

POST /api/v1/{domain}/workflows/{wf}/instances/start

Response: { "id": "...", "status": { "code": "InProgress" } } — işleme başlandığını gösterir.

Sonra client GET /api/v1/{domain}/workflows/{wf}/instances/{id}/functions/state ile long-polling yapar; status.code = "A" (Active) olduğunda mevcut state'e geçilmiştir.

Karar​

Ne zaman?Tercih
Hızlı, deterministic süreçler (validation, hesaplama)sync=true
Uzun süren süreçler, dış API çağrıları, human task'larsync=false
Mobile/Web client (long-polling kabiliyeti var)sync=false
Backend-to-backend integration (request/response pattern)sync=true

İlgili​