Ana içeriğe geç

Workflow API Kullanımı

Bu sayfa, SkyStudio iş akışlarınızı kendi uygulamalarınızla konuşturmanızı sağlayan Workflow API entegrasyonunu detaylandırır. Sürükle-bırak ile tasarladığınız akıllı otomasyonları, API aracılığıyla sistemlerinize saniyeler içinde entegre edebilirsiniz.

1) API Key nereden alınır?​

Workflow arayüzünde önce çalışmayı Publish(Yayınla) kısmından yayınlamanız gerekiyor. Sonrasında Copy API Key kısmından Workflow API key alınır.

workflow api
workflow api
workflow_api_kolaj_yan_yana
workflow_api_kolaj_yan_yana

2) API Ayarları​

Kullanacağınız API aracında aşağıdaki ayarları uygulamanız gerekiyor.

  • Method: POST
  • Auth: Bearer Token → Workflow API Key
  • Headers: Content-Type = application/json
  • Body: raw → JSON

Endpoint​

MethodPathContent-Type
POST/api/workflow/workflowrunapplication/json

Full URL: https://skystudio.skymod.tech/api/workflow/workflowrun

💡 Neden Bu Parametreleri Kullanıyoruz?​

  • Method: POST Sadece bir veriyi okumakla kalmayıp, SkyStudio üzerinde tasarladığınız iş akışını dışarıdan tetikleyip yeni bir işlem başlattığımız için.

  • Auth: Bearer Token Bu spesifik iş akışını tetiklemeye yetkili olduğunuzu kanıtlayan güvenlik anahtarınızdır (Workflow API Key).

  • Headers: Content-Type: application/json Uygulamanız ile SkyStudio arasındaki veri alışverişinin en evrensel, hızlı ve hatasız formatta yapılmasını sağlamak için.

  • Body: raw → JSON İş akışınızın başlangıç adımının (Node) dışarıdan beklediği dinamik verileri veya tetikleme komutlarını sisteme iletmek için.

Request Variants​

1) Tek Başlangıçlı Node ile Sorgu​

{
  "query": "Test mesajı"
}

2) Birden Fazla Başlangıçlı Node ile Sorgu​

{}

Query parametresi göndermeden sadece token ile istek yapabilirsiniz.

Tek Başlangıçlı Node ile cURL Example​

curl -X POST "https://skystudio.skymod.tech/api/workflow/workflowrun" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_WORKFLOW_KEY" \
    -d '{  "query": "Test mesajı"}'

Birden Fazla Başlangıçlı Node ile cURL Example​

curl -X POST "https://skystudio.skymod.tech/api/workflow/workflowrun" \
  -H "Authorization: Bearer YOUR_WORKFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

3) Sorun Giderme​

  • URL doğru mu?
  • Authorization Bearer token doğru mu?
  • Body formatı node sayısına uygun mu?

Status koduna göre: