Copilot Studio üzerinde api isteğini birden fazla şekilde yapabilirsiniz, Topic içerisinde api çağıran bir flow yada topic içerisinde HTTP Request kartını kullanabilirsiniz,

Modüler olmak adına, topic içerisinde HTTP isteği gönderen bir flow çağıracağız,

Elinizde örnek api yok ise örnek olarak salonumda bulunan termostatın derecesini ve nem oranını görebileceğiniz test API'yi kullanabilirsiniz.

Salon Termostat Api:

Authentication Basic Auth:
Endpoint:https://armanhacikoglu.com/mockapi/climate/
Username: armanh
Password: arman!240397

Copilot studio üzerinde yeni bir Flow oluşturup içerisinde yeni bir action ekliyoruz ve action adı olarak HTTP aratıp, çıkan sonucu kullanıyoruz.

HTTP Eylemini Yapılandırma

Seçiminizin ardından eklenen HTTP eylem kartında, API dokümantasyonunuzun gereksinimlerine göre aşağıdaki alanları doldurun:

• Metot (Method): İsteğin HTTP yöntemini seçin.
  • GET: Bir kaynaktan veri almak için.
  • POST: Yeni bir kaynak oluşturmak için.
  • PUT: Mevcut bir kaynağı tamamen güncellemek için.
  • PATCH: Mevcut bir kaynağı kısmen güncellemek için.
  • DELETE: Bir kaynağı silmek için.

Eklediğiniz HTTP actionın'da doldurmanız gereken alanların çoğu * şeklinde işaretlenmiş durumda, apinizin gereksinime göre (neredeyse her apide) Header kısmına Authentication eklemeniz gerekebilir.

Bu örnekte termostat APIsinden veri alacağımız için URL alanını https://armanhacikoglu.com/mockapi/climate/ ,Method'umuzu GET olarak seçiyoruz, ve şifre ile güvenlik kontrolü olduğu için Header kısmına Authentication alanını ekliyoruz.

Basic Auth Header Generator:

Basic HTTP Authentication (Temel Kimlik Doğrulama) şemasını kullanan API'lere yapılan isteklerde, kullanıcı adı ve şifre gibi kimlik bilgileri doğrudan ve açık metin (plain text) olarak gönderilmez. Bunun yerine, standartlaştırılmış bir kodlama sürecinden geçirilerek Authorization HTTP başlığı içerisinde iletilirler.

Güvenli ve standartlara uygun bir Authorization başlığı oluşturma süreci iki temel adımdan oluşur:

1. Kimlik Bilgilerini Birleştirme: Kullanıcı adı ve şifre, aralarında iki nokta üst üste (:) olacak şekilde birleştirilir.
   1. Format: kullanıcıadı:şifre
2. Base64 Kodlaması: Önceki adımda oluşturulan birleşik metin, Base64 standardına göre kodlanır. Bu işlem, kimlik bilgilerini ağ üzerinde güvenli bir şekilde taşınabilir bir formata dönüştürür ancak şifrelemez.

Aşağıdaki js ve html ile Authentication header oluşturma işlemini otomatik olarak sadece kullanıcı adı ve şifreyi girerek gerçekleştirebilirsiniz.

Elde edilen Base64 kodlanmış çıktısı, Basic ön eki ile birlikte Authorization başlığının değeri olarak atanır.

Ardından APInin döndürdüğünü sonuca göre verinizi kullanabilirsiniz. Örnek olarak termostat APIsine bakarsak, salondaki sıcaklık 30.5 derece ve %47 oranında nem gözükmekte.