MICRO-EPSILON colorSENSOR CFO200 Betriebsanleitung Seite 115

Anhang | API-Kommunikation mit Controller (Version 0.7.1)
A 3.5.3.35 Vergangene Messwerte (stream=0)
Ohne Angabe weiterer Parameter werden verzögerungsfrei die letzten im Buffer vorhandenen Messwerte
zurückgeliefert.
GET
Die beiden optionalen und kombinierbaren Filter min_age und max_age erlauben die Beschränkung der zu-
rückgelieferten Einträge auf einen definierten Zeitbereich (definiert als Sekunden im Vergleich zum Zeitpunkt
der Abfrage).
Die ausgelieferten Details entsprechen dem unter /api/sensor/samples/current beschriebenen
Datensatz.
A 3.5.3.36 Stream-Ausgabe (stream=1)
Mit der Übergabe des Query-Arguments stream=1 wird die Abfrage in den Stream-Modus umgeschaltet.
Bei der Abfrage eines Streams sind die Ausgabeformate JSON und CSV auswählbar.
Diese Abfrage liefert fortlaufend zeilenweise neue Sample-Werte aus, bis der Client die Verbindung schließt.
Die folgenden Parameter werden akzeptiert:
Attribut
format
stream_count
delimiter
Die zurückgelieferten Attribute entsprechen denen der /api/sensor/samples/current Abfrage.
Das CSV-Ausgabeformat ist abgeleitet vom primären JSON-Ausgabeformat. Das CSV-Ausgabeformat beginnt
in jedem Fall mit dem Tabellenkopf. Die darin enthaltenen Schlüssel für die Elemente des JSON-Datensatz
entsprechen dem Schema representations.RGB[0]. Dictionary-Schlüssel werden durch Punkt getrennt.
Array-Indizes werden durch eckige Klammern eingefasst. Die Nummerierung der Spalten des CSV- Ausga-
beformats ist nicht spezifiziert und kann sich in Zukunft ändern. Die Spaltennummer der gewünschten Werte
muss also von der Position des dazugehörigen Spaltenkopfes dynamisch abgeleitet werden.
colorSENSOR CFO
Mögliche Inhalte Standardwert
json / csv json
Natürliche Zahl 0
Zeichenkette , (Komma)
Inhalt
Ausgabeformat
Endlose Abfrage von Datensätzen (=0) oder
einer definierten Anzahl von Datensätzen
(>0)
Spaltentrennzeichen für CSV-Ausgabe
Seite 115