#HTTP İsteği

This feature is provided by the plugin «İş Akışı: HTTP İstek Düğümü»

#Giriş

Başka bir web sistemiyle etkileşim kurmanız gerektiğinde, HTTP İsteği düğümünü kullanabilirsiniz. Bu düğüm, yürütüldüğünde yapılandırmasına göre belirtilen adrese bir HTTP isteği gönderir. Harici sistemlerle veri alışverişi yapmak için JSON veya application/x-www-form-urlencoded formatında veri taşıyabilir.

Postman gibi istek gönderme araçlarına aşina iseniz, HTTP İsteği düğümünün kullanımına hızla hakim olabilirsiniz. Bu araçlardan farklı olarak, HTTP İsteği düğümündeki tüm parametreler mevcut iş akışındaki bağlam değişkenlerini kullanabilir, bu da sistemin iş süreçleriyle organik bir entegrasyon sağlar.

#Kurulum

Yerleşik bir eklentidir, kurulum gerektirmez.

#Düğüm Oluşturma

İş akışı yapılandırma arayüzünde, akıştaki artı ("+") düğmesine tıklayarak bir "HTTP İsteği" düğümü ekleyin:

#Düğüm Yapılandırması

#İstek Yöntemi

İsteğe bağlı HTTP istek yöntemleri: GET, POST, PUT, PATCH ve DELETE.

#İstek Adresi

HTTP hizmetinin URL'si, protokol kısmını (http:// veya https://) içermelidir. https:// kullanılması önerilir.

#İstek Veri Formatı

Bu, istek başlığındaki Content-Type'tır. Desteklenen formatlar için "İstek Gövdesi" bölümüne bakın.

#İstek Başlığı Yapılandırması

İstek Başlığı bölümündeki anahtar-değer çiftleri. Değerler, iş akışı bağlamındaki değişkenleri kullanabilir.

#İstek Parametreleri

İstek sorgu bölümündeki anahtar-değer çiftleri. Değerler, iş akışı bağlamındaki değişkenleri kullanabilir.

#İstek Gövdesi

İsteğin Gövde kısmı. Seçilen Content-Type'a bağlı olarak farklı formatlar desteklenir.

#application/json

Standart JSON formatlı metni destekler. Metin düzenleyicinin sağ üst köşesindeki değişken düğmesini kullanarak iş akışı bağlamındaki değişkenleri ekleyebilirsiniz.

#application/x-www-form-urlencoded

Anahtar-değer çifti formatı. Değerler, iş akışı bağlamındaki değişkenleri kullanabilir. Değişkenler dahil edildiğinde, bir dize şablonu olarak ayrıştırılacak ve nihai dize değerine birleştirilecektir.

#application/xml

Standart XML formatlı metni destekler. Metin düzenleyicinin sağ üst köşesindeki değişken düğmesini kullanarak iş akışı bağlamındaki değişkenleri ekleyebilirsiniz.

#multipart/form-data v1.8.0+

Form verileri için anahtar-değer çiftlerini destekler. Veri türü bir dosya nesnesi olarak ayarlandığında dosyalar yüklenebilir. Dosyalar yalnızca bağlamda mevcut dosya nesnelerinden (örneğin, bir dosya koleksiyonu üzerindeki sorgunun sonuçları veya ilişkili bir dosya koleksiyonundan gelen ilişkili veriler) değişkenler aracılığıyla seçilebilir.

#Zaman Aşımı Ayarları

Bir istek uzun süre yanıt vermediğinde, zaman aşımı ayarı yürütmesini iptal etmek için kullanılabilir. İstek zaman aşımına uğrarsa, mevcut iş akışı başarısız bir durumla erken sonlandırılacaktır.

#Başarısızlıkları Yoksay

İstek düğümü, 200 ile 299 (dahil) arasındaki standart HTTP durum kodlarını başarılı, diğerlerini ise başarısız olarak kabul eder. Eğer "Başarısız istekleri yoksay ve iş akışına devam et" seçeneği işaretlenirse, istek başarısız olsa bile iş akışındaki sonraki düğümler yürütülmeye devam edecektir.

#Yanıt Sonucunu Kullanma

Bir HTTP isteğinin yanıt sonucu, sonraki düğümlerde kullanılmak üzere JSON Sorgusu düğümü tarafından ayrıştırılabilir.

v1.0.0-alpha.16 sürümünden bu yana, istek düğümünün yanıt sonucunun üç bölümü ayrı değişkenler olarak kullanılabilir:

• Yanıt durum kodu
• Yanıt başlıkları
• Yanıt verileri

Yanıt durum kodu genellikle 200, 403 gibi sayısal biçimde standart bir HTTP durum kodudur (hizmet sağlayıcı tarafından verilir).

Yanıt başlıkları JSON formatındadır. Hem başlıklar hem de JSON formatlı yanıt verileri, kullanılmadan önce bir JSON düğümü kullanılarak ayrıştırılmalıdır.

#Örnek

Örneğin, bildirim SMS'leri göndermek için bir bulut platformuyla bağlantı kurmak amacıyla istek düğümünü kullanabiliriz. Bir bulut SMS API'si için yapılandırma aşağıdaki gibi görünebilir (parametreleri uyarlamak için ilgili API'nin belgelerine başvurmanız gerekecektir):

İş akışı bu düğümü tetiklediğinde, yapılandırılmış içerikle SMS API'sini çağıracaktır. İstek başarılı olursa, bulut SMS hizmeti aracılığıyla bir SMS gönderilecektir.