# Web service-rajapinta

Web service -rajapinnan voidaan kutsua seuraavia operaatioita.

<table border="1" id="bkmrk-operaatio-metodi-url" style="border-collapse: collapse; width: 100%; height: 253.36px;"><tbody><tr style="height: 29.7969px;"><td style="width: 24.9691%; height: 29.7969px;">**Operaatio**</td><td style="width: 24.9691%; height: 29.7969px;">**Metodi**</td><td style="width: 24.9691%; height: 29.7969px;">**URL-pohja**</td><td style="width: 24.9691%; height: 29.7969px;">**Parametrit**</td></tr><tr style="height: 57.7812px;"><td style="width: 24.9691%; height: 57.7812px;">Kirjautuminen (käyttäjä)</td><td style="width: 24.9691%; height: 57.7812px;">POST</td><td style="width: 24.9691%; height: 57.7812px;">plc.php</td><td style="width: 24.9691%; height: 57.7812px;">user=\[username\]

secret=\[passwd\]

</td></tr><tr style="height: 46.5938px;"><td style="width: 24.9691%; height: 46.5938px;">Kirjautuminen (robotti)</td><td style="width: 24.9691%; height: 46.5938px;">GET</td><td style="width: 24.9691%; height: 46.5938px;">plc.php</td><td style="width: 24.9691%; height: 46.5938px;">&amp;key=\[keyString\]&amp;id=\[idString\]</td></tr><tr style="height: 29.7969px;"><td style="width: 24.9691%; height: 29.7969px;">Lue pisteen arvo</td><td style="width: 24.9691%; height: 29.7969px;">GET</td><td style="width: 24.9691%; height: 29.7969px;">plc.php</td><td style="width: 24.9691%; height: 29.7969px;">&amp;get=\[pointName\]</td></tr><tr style="height: 29.7969px;"><td style="width: 24.9691%; height: 29.7969px;">Kirjoita pisteen arvo</td><td style="width: 24.9691%; height: 29.7969px;">GET</td><td style="width: 24.9691%; height: 29.7969px;">plc.php</td><td style="width: 24.9691%; height: 29.7969px;">&amp;set=\[pointName\]&amp;value=\[json\]</td></tr><tr style="height: 29.7969px;"><td style="width: 24.9691%; height: 29.7969px;">Historia-datan lukeminen</td><td style="width: 24.9691%; height: 29.7969px;">GET</td><td style="width: 24.9691%; height: 29.7969px;">plc.php</td><td style="width: 24.9691%; height: 29.7969px;">&amp;historybuffer=\[bufferName\]  
&amp;db=\[historyfile\]&amp;time=\[starttime\]</td></tr><tr style="height: 29.7969px;"><td style="width: 24.9691%; height: 29.7969px;">Listaa pisteet</td><td style="width: 24.9691%; height: 29.7969px;">GET</td><td style="width: 24.9691%; height: 29.7969px;">plc.php</td><td style="width: 24.9691%; height: 29.7969px;">&amp;list=\[namefilter\]&amp;fields=\[fieldfilter\]</td></tr></tbody></table>

**HUOM!** Operaatioita voidaan suorittaa vain onnistuneen kirjautumisen jälkeen.

Rajapinnassa on **kaksi eri kirjautumistapaa:**  
 • POST-pohjainen kirjautuminen on tarkoitettu ihmisten käytettäväksi käyttöpaneeleiden kautta. Luo uuden session. (ei siis yleensä web service käyttöön).  
 • GET-pohjainen (shared key -tyyppinen) kirjautuminen on tarkoitettu roboteille ja automaattisten tiedonkeräysjärjestelmien käytettäväksi (ei luo sessiota).

Jaettu tunnistautumisavain syötetään laitteeseen käyttöönoton yhteydessä. Rajapinnan tarjoama data on JSON-muotoista.

Versiossa 3 voi valvomon kautta suorittaa kyselyjä myös ala-asemille. Tällöin ala-aseman NodeID annetaan "remote" -parametrina, mutta muilta osin komento on sama.