{"id":2845,"date":"2020-12-15T14:35:19","date_gmt":"2020-12-15T13:35:19","guid":{"rendered":"http:\/\/blog.phoenixcontact.com\/marketing-pl\/?p=2845"},"modified":"2021-06-17T10:37:56","modified_gmt":"2021-06-17T08:37:56","slug":"interfejs-rest-api-w-automatyce-przemyslowej","status":"publish","type":"post","link":"https:\/\/blog.phoenixcontact.com\/marketing-pl\/interfejs-rest-api-w-automatyce-przemyslowej\/","title":{"rendered":"Interfejs REST API w automatyce przemys\u0142owej"},"content":{"rendered":"\n

Jesie\u0144 w bran\u017cy automatyki zawsze kojarzy\u0142a si\u0119 z mnogo\u015bci\u0105 targ\u00f3w, konferencji i innych wydarze\u0144, na kt\u00f3rych firmy prezentowa\u0142y swoje najnowsze rozwi\u0105zania techniczne. Chocia\u017c w tym roku wi\u0119kszo\u015b\u0107 aktywno\u015bci przenios\u0142a si\u0119 do sieci, nie wp\u0142yn\u0119\u0142o to negatywnie na liczb\u0119 prezentowanych nowo\u015bci i trend\u00f3w.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Jednym z hase\u0142 powtarzanych w odniesieniu do wielu nowych produkt\u00f3w jest \u201eREST API\u201d<\/strong> \u2013 i to zagadnienie chcia\u0142bym nieco przybli\u017cy\u0107.<\/p>\n\n\n\n

Czym jest REST API?<\/h1>\n\n\n\n

Has\u0142o REST API pojawia si\u0119 zawsze w kontek\u015bcie wymiany danych i komunikacji pomi\u0119dzy urz\u0105dzeniami, serwisami lub oprogramowaniem. Nale\u017cy jednak podkre\u015bli\u0107, \u017ce REST API nie jest protoko\u0142em komunikacyjnym, nie jest te\u017c \u017cadnym standardem\u2026 wi\u0119c czym jest? Autor koncepcji \u2013 Roy Fielding \u2013 w swojej pracy doktorskiej<\/a> z 2000 roku wprowadzaj\u0105cej poj\u0119cie, zdefiniowa\u0142 REST (Re<\/strong>presentational S<\/strong>tate T<\/strong>ransfer) jako styl architektury system\u00f3w<\/strong>. Aby urz\u0105dzenie lub system by\u0142o zgodne z REST musi spe\u0142nia\u0107 sze\u015b\u0107 regu\u0142 opisanych we wspomnianej dysertacji:<\/p>\n\n\n\n

  1. Client-Server <\/strong>\u2013 architektura systemu musi opiera\u0107 si\u0119 o dwie niezale\u017cne aplikacje. Klient pobiera lub umieszcza dane na serwerze, ale nie mo\u017ce mie\u0107 \u017cadnego wp\u0142ywu na struktur\u0119 serwera, na przyk\u0142ad na to, gdzie i jak takie dane s\u0105 przechowywane. Analogicznie serwer nie mo\u017ce te\u017c w \u017caden spos\u00f3b wp\u0142ywa\u0107 na funkcjonowanie klienta. Dzi\u0119ki spe\u0142nieniu tej zasady obie odseparowane aplikacje mog\u0105 by\u0107 rozwijane niezale\u017cnie.<\/li>
  2. Stateless <\/strong>\u2013 komunikacja musi odbywa\u0107 si\u0119 w spos\u00f3b bezstanowy. Oznacza to, \u017ce ka\u017cde zapytanie od klienta musi zawiera\u0107 komplet informacji pozwalaj\u0105cy na prawid\u0142ow\u0105 interpretacj\u0119 zapytania przez serwer. \u017badne dane odno\u015bnie sesji komunikacyjnych nie mog\u0105 by\u0107 przechowywane na serwerze.<\/li>
  3. Cache<\/strong> \u2013 serwer, odpowiadaj\u0105c na zapytanie o dane, opr\u00f3cz warto\u015bci musi r\u00f3wnie\u017c podawa\u0107 informacje o mo\u017cliwo\u015bci i ewentualnym czasie buforowania. Parametry rzadko zmieniaj\u0105ce swoj\u0105 warto\u015b\u0107 powinny by\u0107 oznaczane jako cacheable<\/em> i zapami\u0119tywane przez klienta, co prowadzi do redukcji ilo\u015bci zapyta\u0144 obs\u0142ugiwanych przez serwer.<\/li>
  4. Uniform Interface<\/strong> \u2013 interfejs dost\u0119pu do wszystkich zasob\u00f3w musi by\u0107 ujednolicony.<\/li>
  5. Layered System<\/strong> \u2013 systemy musz\u0105 by\u0107 zaprojektowane z podzia\u0142em na hierarchiczne warstwy. Klient powinien komunikowa\u0107 si\u0119 i by\u0107 w stanie zobaczy\u0107<\/em> tylko t\u0119 warstw\u0119, z kt\u00f3r\u0105 prowadzi interakcj\u0119. Takie odseparowanie pozwala na zwi\u0119kszenie bezpiecze\u0144stwa danych.<\/li>
  6. Code-On-Demand <\/strong>\u2013  jest to regu\u0142a opcjonalna. Serwer mo\u017ce w ramach odpowiedzi udost\u0119pni\u0107 nie tylko czyste dane, ale te\u017c skrypt lub aplet, kt\u00f3ry mo\u017ce takie dane agregowa\u0107 lub interpretowa\u0107 w z g\u00f3ry za\u0142o\u017cony spos\u00f3b.<\/li><\/ol>\n\n\n\n

    System udost\u0119pniaj\u0105cy dane dzia\u0142aj\u0105cy zgodnie z powy\u017cszymi zasadami REST mo\u017cemy nazwa\u0107 systemem posiadaj\u0105cym interfejs REST API. Taki system umo\u017cliwia udost\u0119pnienie swoich zasob\u00f3w w prosty i elastyczny spos\u00f3b dla wszystkich klient\u00f3w przy u\u017cyciu istniej\u0105cych protoko\u0142\u00f3w. Opisane powy\u017cej teoretyczne za\u0142o\u017cenia mog\u0105 si\u0119 wydawa\u0107 nieco enigmatyczne, ale korzystanie z urz\u0105dze\u0144 lub system\u00f3w z zaimplementowanym REST API jest bardzo proste i przyjemne.<\/p>\n\n\n\n

    Pobieranie danych z urz\u0105dzenia<\/h1>\n\n\n\n

    Komunikacja z systemami posiadaj\u0105cymi REST API odbywa si\u0119 najcz\u0119\u015bciej za pomoc\u0105 protoko\u0142u HTTP. Zapytanie, zgodnie z zasad\u0105 stateless<\/em>, posiada wszystkie informacje wymagane do udzielenia odpowiedzi:<\/p>\n\n\n\n