Genel Kurallar

  • REST API temel URL’nin altında mevcuttur:

/public/external/api

  • Tüm talepler POST aracılığıyla gönderilmelidir.
  • REST API yalnızca HTTPS üzerinden yapılan istekleri destekler.
  • Talepler aşağıdaki Başlıkları içermelidir:
Düzenle

Başlık Adı



Başlık Değeri



Açıklama



İçerik türü



application/json



sabit



auth



123…xyz



“API Erişimi” Sekmesinden API Anahtarı



imza



Base64 kodlu imza



ile oluşturulan yükün imzası


“API Erişimi” Sekmesinden özel Anahtar


  • İstek gövdesi, aşağıdaki değerleri içermesi gereken json kodlu bir nesne olmalıdır:
Düzenle

Saha



Alan Örnek Değer



Açıklama



api



v2/device/listdevices



API’nin adı



zaman



1529662725



İstemci makinenin Unix Zaman Damgası (UTC).


İzin verilen maksimum zaman farkı


istemci ve sunucu arasında 30


dakikalar.


  • Başarı durumunda API istenen verileri (aşağıdaki Sorgulara bakın) ve bir HTTP durum kodu 200 döndürür.
  • Bir hata oluşursa, HTTP durum kodu hataya bağlı olarak 4xx ile 5xx arasında olacaktır ve yanıt nesnesi, insan tarafından okunabilir hata mesajlarının bir listesini içeren “errors” anahtarına sahip bir dizi içerecektir.
  • Bir aygıt için eşleşen veri yoksa boş bir dizi döndürülür.
  • Eğer bir cihaz kimliği mevcut değilse, geri dönüş verisi null olacaktır.
This site is registered on wpml.org as a development site. Switch to a production site key to remove this banner.