API ürününün işleyişi
API çağrı türleri
GET, POST ve DELETE API çağrı türleri ESET PROTECT On-Prem API içerisinde mevcuttur.
•GET çağrıları herhangi bir giriş parametresi içerir (gövdeleri yoktur) ve verileri doğrudan URL'de gönderir. İstek çağrısı değiştirilemez; sadece yürütülebilir.
•POST çağrıları için bir istek gövdesi gereklidir; parametreler her bir POST çağrısı için belgelenir.
•Sayfa seçimi (page_size) içeren API isteklerinde, varsayılan sayfa boyutu 100 ve maksimum boyut 10000 olarak ayarlanmıştır.
Her çağrı şunlardan oluşur:
•Çağrı türü
•İstek URL'si
•İstek başlığı (kimlik doğrulama token'ından oluşabilir)
•İstek gövdesi (özellikle POST çağrılarında veri içerir)
Sunucu yanıt yapısı
Her API çağrısı REST sunucusundan bir yanıt alır. Yanıt, sunucu yanıt kodu ve JSON biçiminde veri olarak biçimlendirilen yanıttan oluşur.
Yanıt şunlardan oluşmaktadır:
•Sunucu kodu
•Yanıt gövdesi
•Yanıt başlıkları
API çağrılarına örnekler
GET
Bir ilke göster (Policy_UUID, Web Konsolu'ndan alınmıştır):
Yöntem |
GET |
İşlev |
|
URL |
https://protect_server:9443/v2/policies/Policy_UUID |
Gövde |
|
Yetkilendirme |
Bearer token |
POST
Cihazı belirli bir statik gruba taşı (Bilgisayar kimliği URL'ye eklenir):
Yöntem |
POST |
İşlev |
|
URL |
https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move |
Gövde |
{ "newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1" } |
Yetkilendirme |
Bearer token |