Technische Informationen zur Test-Schnittstelle
Sie möchten die Implementierung im Vorfeld ausprobieren?
Kein Problem, Ihnen steht eine öffentlich zugängliche Test-REST-Schnittstelle zur Verfügung. Die Test-Schnittstelle bildet das Verhalten des echten Systems weitgehend ab. Trotzdem kann es zu vereinzelten Einschränkungen bzw. Besonderheiten kommen, auf die im Folgenden näher eingegangen wird.
Direkt zur Test-Schnittstelle
Wichtiges To-Do: Um einen GET-Request direkt in Swagger testen zu können, müssen Sie den Request-Body {} entfernen.
Möglichen Responses der Test-Schnittstelle:
✅ POST | 200 OK
Antwortet MetriX der Test-Schnittstelle mit 200 OK, wurde der Identifikator erfolgreich akzeptiert und das System befindet sich in einem Zustand, in dem eine Messung möglich ist.
Bitte beachten Sie: Diese Funktion kann getestet werden, ist jedoch in der bereitgestellten Testumgebung nur eingeschränkt sinnvoll, da keine tatsächliche Messung erfolgt.
✅ GET | 200 OK
Die Test-Schnittstelle liefert den Response-Body gemäß der Beschreibung im Artikel Messungen über die MetriX REST-Schnittstelle.
Bitte beachten Sie: Die Abmessungen, das Gewicht sowie die Bilddaten in der Testumgebung werden zufällig generiert. Die Werte ändern sich bei jedem Request und stimmen daher nicht zwangsläufig miteinander überein.
Zudem kann die Anzahl und Auflösung der bereitgestellten Bilder von der des final gebuchten Systems abweichen.
❌ POST/GET | 400 Bad Request
Wird der Identifikator nicht akzeptiert oder befindet sich das System in einem Zustand, der keine Messungen zulässt, erhalten Sie die im Artikel Messungen über die MetriX REST-Schnittstelle beschriebene Response. Zur Simulation der beschriebenen Fehler reagiert die Schnittstelle auf besondere Identifikatoren:
-
-
-
Invalid Identifier
-
-
-
-
-
Additional Identifier disabled
-
Verification required
-
-
❌ GET | 404 Not Found
Wie für die anderen, zuvor bereits erwähnten Fehler gibt es auch hierfür einen speziellen Identifikator: https://metrix-api.metrilus.de/measurement/timeout