Web URL'ler sayfasında yeni bir WebURL oluşturabilir veya mevcut WebURL kayıtlarını görüntüleyebilirsiniz.
Menü yolu: Sistem Yöneticisi > Webhook > Web URLs
Tabloda, her WebURL hakkında temel bilgileri bir bakışta sunan sütunları görebilirsiniz. Sütunları tablo ayarlarından ihtiyaçlarınıza göre özelleştirebilirsiniz.
Yeni bir WebURL oluşturmak için Yeni düğmesine tıklayın. Ayrıca işlem menüsündeki Düzenle düğmesine tıklayarak mevcut bir WebURL'yi düzenleyebilir veya Sil düğmesine tıklayarak bir WebURL kaydını silebilirsiniz.
WebURL sayfasında GET, POST, PUT ve DELETE yöntemlerini kullanarak web servislerine istek gönderebilirsiniz.
Değişkenler (Variables) bölümü, kullanabileceğiniz fonksiyonlar ve değişkenler hakkında bilgilendirici içerik barındırır.
Yöntemler (Methods)
GET
Sunucudan veri almak için kullanılır.
En sık kullanılan HTTP yöntemidir.
Parametreler URL içinde gönderilebilir.
POST
Sunucuya veri göndermek için kullanılır.
Yeni veri oluşturmak veya mevcut veriyi güncellemek için kullanılır.
Veriler genellikle istek gövdesinde (request body) gönderilir.
PUT
Mevcut bir kaynağı güncellemek için kullanılır.
Kaynağın tamamını güncellemek için kullanılır.
Veriler genellikle istek gövdesinde (request body) gönderilir.
DELETE
Sunucudan bir kaynağı silmek için kullanılır.
Silinecek kaynağın ID'si URL içinde belirtilir.
Parametreler (Params)
Bu bölüm, API isteklerini özelleştirmenizi sağlar. Parametre Ekle (Add Parameter) düğmesine tıklayarak birden fazla parametre ekleyebilirsiniz. Sürükle-bırak özelliğini kullanarak parametrelerin sırasını değiştirebilirsiniz.
Alan | Açıklama |
Anahtar (Key) | API'nin beklediği veri parçasının adıdır. Örneğin bir kullanıcının adını göndermek istiyorsanız anahtar "username" olabilir. |
Değer (Value) | Anahtara karşılık gelen asıl veridir. "username" anahtarı için değer, kullanıcının gerçek adı olur (ör. "john.walker"). |
Açıklama (Description) | Parametrenin ne için kullanıldığını açıklayan metindir. İsteğe bağlıdır ancak parametrelerin neyi temsil ettiğini anlamanıza yardımcı olabilir. |
Yetkilendirme (Authorization)
Bu bölümde, daha önce Web URL Auth sayfasında oluşturulan kimlik doğrulama adlarına dayalı seçenekler listelenir. Listeden bir kimlik doğrulama adı seçtiğinizde, ilgili yetkilendirme yöntemine ait yöntem adı aşağıda görüntülenir.
Yetkilendirme özelliği, API'ye erişimi denetlemek için bir kimlik doğrulama yöntemi olarak kullanılır. Web URL yetkilendirmesinin temel çalışma prensibi şu şekildedir:
İstemci, API'ye erişmek için bir istek gönderir.
API, kimlik doğrulama için istemciyi bir Web URL'ye yönlendirir.
İstemci, Web URL üzerinde kimlik bilgilerini (kullanıcı adı ve parola gibi) girer.
Web URL, kimlik bilgilerini doğrular ve istemciye bir kimlik doğrulama token'ı gönderir.
İstemci, API'ye erişmek için kimlik doğrulama token'ını kullanır.
Başlıklar (Headers)
Başlıklar bölümünü, API isteklerine ve yanıtlarına başlık (header) eklemek için kullanabilirsiniz. Başlıklar, API'ye ek bilgi göndermek ve API'den ek bilgi almak için kullanılır.
Alan | Açıklama |
Anahtar (Key) | API'nin beklediği veri parçasının adıdır. Örneğin bir kullanıcının adını göndermek istiyorsanız anahtar "username" olabilir. |
Değer (Value) | Anahtara karşılık gelen asıl veridir. "username" anahtarı için değer, kullanıcının gerçek adı olur (ör. "john.walker"). |
Açıklama (Description) | Parametrenin ne için kullanıldığını açıklayan metindir. İsteğe bağlıdır ancak parametrelerin neyi temsil ettiğini anlamanıza yardımcı olabilir. |
Gövde (Body)
Bir HTTP isteğinin gövdesi, sunucuya gönderilen verileri içerir. Bu veriler çeşitli formatlarda olabilir. Web URL gövdesinin kullanım alanları:
Form Gönderimi: Giriş formlarındaki verileri sunucuya göndermek için kullanılır.
API İstekleri: API'lere veri göndermek için kullanılır.
Dosya Yüklemeleri: Sunucuya dosya yüklemek için kullanılır.
Kullanılabilen gövde türleri şunlardır:
Tür | Açıklama |
None (Yok) | İstek gövdesinde herhangi bir veri gönderilmez. Basit GET istekleri gibi veri gönderilmesinin gerekmediği durumlarda kullanılır. |
Form-Data | Web formlarında kullanılan veri gönderim formatına benzer. Verileri anahtar-değer çiftleri olarak göndermek için kullanılır. Form-data türü seçildiğinde, arayüz her anahtar ve değer için ayrı alanları doldurmanızı ister. |
x-www-form-urlencoded | Form-data türüne benzer şekilde, verileri anahtar-değer çiftleri olarak göndermek için kullanılır. Ancak form-data'dan farklı olarak veriler URL kodlamalı (URL-encoded) formatta gönderilir. Bu format bazı eski API'ler tarafından tercih edilebilir. |
Raw (Ham) | Herhangi bir format kısıtlaması olmadan ham veri göndermek için kullanılır. JSON, XML, metin veya ikili (binary) veri gibi farklı formatlarda veri gönderebilirsiniz. Raw türü seçildiğinde, istenen veriyi arayüzdeki istek gövdesine girmeniz gerekir. |
Yanıt Manipülasyonu (Response Manipulation)
Web URL Yanıt Manipülasyonu, bir web sunucusundan gelen yanıtları değiştirmek için kullanılan bir tekniktir. Bu teknik, aşağıdaki örneklerde görüldüğü gibi çeşitli amaçlarla kullanılabilir.
Yanıt Manipülasyonu örnekleri
Yanıtları Biçimlendirme: Yanıt Manipülasyonu, bir web sunucusundan gelen JSON yanıtını HTML tablosuna dönüştürmek için kullanılabilir.
Hassas Bilgileri Gizleme: Bir web sunucusundan gelen yanıtlar, kredi kartı numaraları veya sosyal güvenlik numaraları gibi hassas bilgileri gizlemek için değiştirilebilir.
Yanıtları Test Etme: Yanıt Manipülasyonu, web uygulamalarını test etmek amacıyla farklı hata kodları veya yanıt gövdeleri oluşturmak için kullanılabilir.
Test
Web URL test modülü, bir web sayfasının veya web API'sinin işlevselliğini test etmek için kullanılan bir araçtır. Bu araç, bir web sunucusuna HTTP istekleri gönderip yanıtları analiz ederek çalışır.
Yanıt bölümü (Response Section)
Web URL Yanıt bölümü, web sunucusundan alınan yanıta ilişkin bilgileri görüntüler. Bu bölüm aşağıdaki bilgileri içerir:
Durum Kodu (Status Code): HTTP isteğinin başarı durumunu gösteren koddur. Örneğin 200 OK kodu, isteğin başarılı olduğunu belirtir.
Başlıklar (Headers): Web sunucusu tarafından gönderilen ek bilgilerdir. Örneğin Content-Type başlığı, yanıtın türünü belirtir.
Gövde (Body): Web sunucusundan alınan asıl verilerdir.
