Inhaltsverzeichnis
Werbung
4 Inbetriebnahme
4.2 REST-Webservices
4.2.1 Einleitung
Das Protokoll des Webservers ist HTTP/1.0. Die Architektur ist dabei nach REST (Representional State
Transfer) realisiert und bietet die Möglichkeit, auf Objekte/Ressourcen zuzugreifen. Ein Beispiel hierfür sind
die Werte im Objektverzeichnis.
Die unterstützten Operationen sind hierbei:
■ GET: Anforderung einer Ressource
■ POST: Hinzufügen einer neuen Ressource
4.2.2 Ressourcen-Namen
Der Name einer Ressource wird immer in der vom Internet bekannten URI (Uniform Resource Identifier)-
Notation angegeben. Die Steuerung unterstützt über diese URI den Zugriff auf das Objektverzeichnis . Der
Identifier hierfür ist:
■ Od: Objektverzeichnis
Beispiel
Zugriff auf einen Wert im Objektverzeichnis:
GET /od/6040/00 HTTP/1.0
Mit diesem String erfolgt der Zugriff auf den Eintrag 6040
Objektverzeichnis.
Die Rückantwort erfolgt als JSON-String und gibt den Inhalt dieses Objektes wieder:
HTTP/1.0 200 OK
Server: uip/1.0
Cache-Control: no-cache, no-store, private
Content-type: application/json
"0006"
Schreiben eines Werts ins Objektverzeichnis:
POST /od/6040/00 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Form item: ""000F"" = ""(Key: "000F", Value:)
Mit diesem String wird der Wert "15(0F
Die Steuerung erhält eine Bestätigung mit dem Status-Code 200 OK:
HTTP/1.0 200 OK
Server: uip/1.0
4.2.3 Zugriff auf das Objektverzeichnis
Folgende URIs ermöglichen einen Zugriff auf das Objektverzeichnis:
<IP-Adresse>/od/xxxx/yy
Fordert den Eintrag xxxx Subindex yy aus dem Objektverzeichnis an.
Version: 1.6.0 / FIR-v2213
Subindex 00
h
)" ins Objekt 6040
Subindex 00
h
h
im
h
geschrieben.
h
28
Werbung
Inhaltsverzeichnis
