Herunterladen Diese Seite drucken

Pilz PITreader REST API Bedienungsanleitung Seite 59

Werbung

HTTP-Endpunkte des PITreaders
5.4.10
HTTP-Endpunkt /api/transponder/userData/addGroupValues (POST)
Über den HTTP-Endpunkt /api/transponder/userData/addGroupValues können mit POST
Daten einer Gerätegruppe im Arbeitsspeicher des PITreaders hinzugefügt werden.
Request
}
Schematische Darstellung
POST https://<IP-Adresse>:<Port-Nummer>/api/transponder/userData/addGroupValues
}
Parameter
Die Parameter müssen im JSON-Format im Body des Requests übergeben werden.
deviceGroup <Nummer>
values
Bedienungsanleitung PITreader REST API, PITreader Firmware V1.5.x
1005365-DE-05
id <Nummer>
type <Typ-ID>
size <Datenlänge>
numericValue <Wert>
stringValue <Wert>
Gerätegruppe, für die der Wert des Parameters gültig
sein soll (optional)
(Datentyp: NUMBER)
Nummer: 0 ... 9999
Hinweis: Das Datenfeld darf nicht übergeben werden,
wenn der Wert des Parameters für alle Gerätegruppen
gültig sein soll.
Übergabe der Parameter
(Datentyp: ARRAY of OBJECT)
Parameter-ID
(Datentyp: NUMBER)
Nummer: 1 ... 65535
Typ-ID des Datentyps
(Datentyp: NUMBER)
Typ-ID: gültige Eingabe siehe [*1]
Maximale Zeichenanzahl für einen Parameter des Daten-
typs "STRING" (optional)
(Datentyp: NUMBER)
Datenlänge: 2 ... 255 (siehe [*1])
Hinweis: "size" muss ausschließlich bei einem Parameter
mit Typ-ID 1 (STRING) übergeben werden. Die Zeichen-
anzahl (Datenlänge in Byte) muss um 1 Byte größer ge-
wählt werden, als die gewünschte Zeichenanzahl; d. h.:
size = <Zeichenanzahl in Byte> + 1 Byte (= Abschlusszei-
chen '\0')
size
<= 255
max
Zahlenwert des Parameters (optional)
Wert: gültige Eingabe in Abhängigkeit von "type" (siehe
[*1])
Hinweis: Das Datenfeld muss nur bei einem Parameter
mit numerischem Wert übergeben werden (Typ-ID 10 ...
15 oder 30).
Zeichenwerte des Parameters (optional)
Wert: gültige Eingabe in Abhängigkeit von "type":
Typ-ID 1 gültiger UTF-8 String
(max. Zeichenanzahl = "size")
| 59

Werbung

loading

Diese Anleitung auch für:

Pitreader firmware v1.5.x