Der folgende Eintrag zeigt eine Musterantwort auf eine erfolgreiche Anfrage, mit der Informationen zum
rc _ stereomatching
minconf
-Parameter des
HTTP/1.1 200
OK
Content-Type:
application/json
Content-Length:
157
{
"name": "minconf",
"min": 0,
"default": 0,
"max": 1,
"value": 0,
"type": "float64",
"description":
"Minimum confidence"
}
Bemerkung: Das tatsächliche Verhalten, die zulässigen Anfragen und die speziellen Rückgabecodes hängen
in hohem Maße von der gewählten Ressource, vom Kontext und von der Aktion ab. Siehe die
Ressourcen
(Abschnitt 8.2.2) des rc_visard und einzelnen Parameter und Services jedes
schnitt 6).
8.2.2 Verfügbare Ressourcen und Anfragen
Die für die REST-API verfügbaren Ressourcen lassen sich in folgende Teilbereiche gliedern:
•
Zugriff auf die
/nodes
den, Parametern und verfügbaren Services.
•
/datastreams
Zugriff auf die und Verwaltung der Datenströme der
8.3) des rc_visard.
•
/logs
Zugriff auf die im rc_visard hinterlegten Logdateien.
•
/system
Zugriff auf den Systemzustand, Netzwerkkonfiguration und Verwaltung der Lizenzen sowie der
Firmware-Updates.
Module, Parameter und Services
Die
Softwaremodule
(Abschnitt 6) des rc_visard heißen in der REST-API Nodes und vereinen jeweils bestimm-
te algorithmische Funktionen. Über folgenden Befehl lassen sich alle Softwaremodule der REST-API mit ihren
jeweiligen Services und Parametern auflisten:
curl -X GET http://<host>/api/v1/nodes
Informationen zu einem bestimmten Modul (z.B.
curl -X GET http://<host>/api/v1/nodes/rc _ stereocamera
Status: Während der Laufzeit stellt jedes Modul Informationen zu seinem aktuellen Status bereit. Dies umfasst
nicht nur den aktuellen Verarbeitungsstatus des Moduls (z.B.
Module melden auch Laufzeitstatistiken oder schreibgeschützte Parameter, sogenannte Statuswerte. Die
rc _ stereocamera
Statuswerte des
curl -X GET http://<host>/api/v1/nodes/rc _ stereocamera/status
Bemerkung: Die zurückgegebenen Statuswerte sind modulspezifisch und werden im jeweiligen
waremodul
(Abschnitt 6) dokumentiert.
8.2. REST-API-Schnittstelle
-Moduls angefordert werden:
Softwaremodule
(Abschnitt 6) des rc_visard mit ihren jeweiligen Laufzeitzustän-
rc _ stereocamera
-Moduls lassen sich beispielsweise wie folgt abrufen:
Softwaremoduls
rc_dynamics Schnittstelle
) lassen sich mit folgendem Befehl abrufen:
running
oder
stale
), sondern die meisten
verfügbaren
(Ab-
(Abschnitt
Soft-
168