Reguli generale

  • API REST este disponibil sub URL-ul de bază:

/public/external/api

  • Toate cererile trebuie să fie trimise prin POST.
  • API REST acceptă solicitări numai prin HTTPS.
  • Cererile trebuie să conțină următoarele antete:
Editare

Denumirea antetului



Valoarea antetului



Descriere



Tip conținut



aplicație/json



fixat



autorizație



123…xyz



Cheia API din fila „Acces API”



semnătură



Semnătura codificată Base64



Semnătura încărcăturii utile generate cu


cheie privată din fila „Acces API”


  • Corpul cererii trebuie să fie un obiect codificat json care trebuie să conțină următoarele valori:
Editare

Câmp



Câmp Exemplu Valoare



Descriere



api



v2/device/listdevices



Denumirea API



timp



1529662725



Timestamp Unix (UTC) al computerului client.


Diferența maximă de timp permisă


între client și server este de 30


minute.


  • În caz de succes, API returnează datele solicitate (a se vedea interogările de mai jos) și un cod de stare HTTP 200.
  • Dacă apare o eroare, codul de stare HTTP va fi între 4xx și 5xx, în funcție de eroare, iar obiectul răspuns va conține un array cu cheia „errors”, care conține o listă de mesaje de eroare lizibile de către om.
  • Dacă nu există date corespunzătoare pentru un dispozitiv, va fi returnat un array gol.
  • Dacă Id-ul unui dispozitiv nu există, datele returnate vor fi nule.
This site is registered on wpml.org as a development site. Switch to a production site key to remove this banner.