HTTP isteği

Genel bakış

HTTP isteği düğümü herhangi bir harici API’yi çağırmanıza olanak tanır—veri getirin, güncelleme gönderin, aksiyon tetikleyin veya yerel entegrasyonu olmayan hizmetlerle entegre olun.

En uygun olduğu durum: Özel API entegrasyonları, harici veri getirme, webhook gönderme ve herhangi bir HTTP tabanlı hizmete bağlanma.

Yapılandırma

cURL’den içe aktar

Tüm alanları (URL, yöntem, başlıklar, parametreler) otomatik doldurmak için bir cURL komutu yapıştırmak üzere "cURL’den içe aktar"a tıklayın. API belgelerinden istekleri hızlı kurmak için idealdir.

URL (Zorunlu)

Çağrılacak API uç noktası. Üç girdi modunu destekler:

Manuel mod: URL’yi isteğe bağlı değişkenlerle doğrudan girin

https://api.example.com/users/{{trigger.output.user_id}}/orders

Otomatik mod: Yapay zeka URL’yi iş akışı bağlamına göre otomatik belirler

Prompt AI modu: URL’yi üretmesi için yapay zekaya talimat verin

Construct the API URL for fetching user {{trigger.output.user_id}} from our CRM system

Yöntem

HTTP yöntemini seçin:

• GET: Veri getir
• POST: Yeni kaynaklar oluştur
• PUT: Mevcut kaynakları değiştir
• PATCH: Mevcut kaynakları güncelle
• DELETE: Kaynakları kaldır

Başlıklar

Özel başlıkları anahtar-değer çiftleri olarak ekleyin. Yaygın başlıklar:

Kimlik doğrulama:

Key: Authorization
Value: Bearer {{trigger.output.api_token}}

İçerik türü:

Key: Content-Type
Value: application/json

Birden fazla başlık eklemek için "Başlık ekle"ye tıklayın.

Sorgu parametreleri

Bunları URL’ye eklemek yerine URL sorgu parametrelerini anahtar-değer çiftleri olarak ekleyin.

Örnek:

URL: https://api.example.com/search
Parameters:
  - Key: query, Value: {{trigger.output.search_term}}
  - Key: limit, Value: 10

Results in: https://api.example.com/search?query=laptops&limit=10

Gövde (yalnızca POST/PUT/PATCH)

İstek yükü, tipik olarak JSON biçiminde. Önceki düğümlerden değişkenleri destekler.

{
  "name": "{{trigger.output.name}}",
  "email": "{{trigger.output.email}}",
  "status": "{{agent.output.structured.category}}",
  "metadata": {
    "source": "workflow",
    "processed_at": "{{trigger.output.timestamp}}"
  }
}

Örnek kullanım senaryoları

Kullanıcı verisi getir (GET)

Method: GET
URL: https://api.crm.com/users/{{trigger.output.user_id}}
Headers:
  - Authorization: Bearer YOUR_TOKEN

Kayıt oluştur (POST)

Method: POST
URL: https://api.system.com/records
Headers:
  - Content-Type: application/json
Body:
{
  "title": "{{trigger.output.title}}",
  "category": "{{agent.output.structured.category}}",
  "priority": "{{agent.output.structured.priority}}"
}

Parametrelerle ara (GET)

Method: GET
URL: https://api.example.com/search
Query Parameters:
  - q: {{trigger.output.search_term}}
  - limit: 20
  - format: json

Durumu güncelle (PATCH)

Method: PATCH
URL: https://api.app.com/items/{{trigger.output.id}}
Headers:
  - Content-Type: application/json
Body:
{
  "status": "completed",
  "updated_by": "workflow"
}

Yanıt verisine erişme

HTTP isteği yürütüldükten sonra yanıta sonraki düğümlerde erişin:

{{http_node.output.status}}              → Status code (200, 404, etc.)
{{http_node.output.data}}                 → Response body
{{http_node.output.data.user.name}}       → Nested response data
{{http_node.output.data.items[0].id}}     → Array items
{{http_node.output.headers}}              → Response headers

Yanıt durum kodları

İsteğin başarılı olup olmadığını kontrol etmek için durum kodunu kullanın:

{{ http_node.output.status === 200 }}     → Success
{{ http_node.output.status >= 400 }}      → Error occurred

En iyi uygulamalar

API belgelerinden çalışan bir cURL komutunuz varsa, tüm alanları doğru kurmak için "cURL’den içe aktar"ı kullanın.

Her zaman hata işleme ekleyin. {{ http_node.output.status === 200 }} kontrol etmek için HTTP isteğinden sonra bir Koşul düğümü kullanın.

Sorgu parametrelerini URL’ye sabit kodlamak yerine Parametreler bölümüne ekleyin. Bu, yönetmeyi kolaylaştırır.

İş akışınızın geri kalanını kurmadan önce isteğin çalıştığını doğrulamak için düğümün test düğmesini kullanın.

Sonraki adımlar

• Webhook tetikleyicisi — HTTP istekleri alın
• Kod düğümü — API yanıtlarını dönüştürün