Beispiele für REST-API-Clients

Die API des REST-Plugins stellt eine generische Schnittstelle bereit, die das Erstellen vielfältiger Anwendungen für die Interaktion mit MERLIC ermöglicht. Die im Lieferumfang enthaltene integrierte Webanwendung veranschaulicht, wie eine solche Anwendung aussehen könnte. Um Sie bei der Erstellung eigener Anwendungen zu unterstützen, umfasst MERLIC einige Beispiele für REST-API-Clients in verschiedenen Programmiersprachen. Die Beispiele veranschaulichen verschiedene Funktionen für die Interaktion mit MERLIC. Sie können den Quellcode der Beispiele als Vorlage für eigene Anwendungen verwenden und je nach Bedarf anpassen.

Die Beispiele befinden sich im Verzeichnis „examples\rest_plugin_clients“ im MERLIC-Installationsverzeichnis. Die einzelnen Beispiele sind in den jeweiligen Unterverzeichnissen der Programmiersprachen gespeichert. Einige Beispiele sind lediglich für HTML verfügbar. Die Logik der einzelnen Beispiele kann jedoch auf andere Programmiersprachen übertragen werden.

Im Folgenden finden Sie allgemeine Informationen zu den verfügbaren Beispielen für REST-API-Clients. Informationen zur Ausführung der Beispiele finden Sie in der Beschreibung im jeweiligen Quellcode der Beispiele.

action_status

Dieses Beispiel veranschaulicht, wie Aktionen an das Bildverarbeitungssystem gesendet werden und wie auf ihren Abschluss gewartet wird. Darüber hinaus wird veranschaulicht, wie ein einzelner Job gestartet und auf das zugehörige Ergebnis gewartet wird.

Dieses Beispiel ist nur in HTML verfügbar.

execution_control

Dieses Beispiel veranschaulicht, wie der aktuelle Zustand der Zustandsmaschine überwacht und die Ausführung gesteuert wird, ohne explizit auf eine Aktion oder den Abschluss eines Jobs zu warten. Es ist so geschrieben, dass eine stabile Handhabung von Bildverarbeitungssystem- und Server-Neustarts sichergestellt ist.

Dieses Beispiel ist nur in HTML verfügbar.

halt_vision_system

Dieses sehr kleine Beispiel zeigt, wie eine HTTP-Anforderung an den REST-Plugin-Server gerichtet wird.

Dieses Beispiel ist in mehreren Programmiersprachen verfügbar.

result_images

Dieses Beispiel veranschaulicht die Verwendung von API-Endpunkten für Bildergebnisse.

Es fragt ab, ob neue Ergebnisse vorhanden sind, und zeigt eine Liste aller Bilder in den jeweiligen Ergebnissen als Thumbnails an. Weiterhin wird angezeigt, wie Größe und Qualität der Bilder über Abfrageparameter angepasst werden können. Darüber hinaus veranschaulicht dieses Beispiel, wie der „x-event-session-id“-Header verwendet werden kann, um ein Zurücksetzen des API-Backends zu erkennen und zu handhaben.

Dieses Beispiel ist nur in HTML verfügbar.