Telematics Interface

The FREE Universal Interface

FAQ

Hier finden Sie Antworten auf die häufigsten Fragen rund um unsere REST-API. Um Zugang zu allen informationen über unsere Schnittstelle zu erhalten, müssen Sie registriert und eingeloggt sein.

Den Linkt zur API finden Sie nach dem Login im Kopfmenü.

Was ist REST?

REST = "Represental State Transfer" ist ein Software-Architekturstil speziell für Webdienste.
Er ist eine Alternative zu z.B. SOAP und RPC. Der Hauptunterschied besteht darin, dass URLs in REST Ressourcen anstelle von Funktionen bezeichnen.
Die Daten werden über das HTTP- oder HTTPS-Protokoll übertragen, das fast überall verfügbar ist. Ein Client kann Ressourcen auf einem Server abfragen, erstellen oder löschen. Dies geschieht durch Angabe eines HTTP-Verbs wie GET, PUT, POST, DELETE (das sind die gängigsten) und der Ressource.
Jede REST-Nachricht ist zustandslos. Das bedeutet, dass eine Nachricht alle für die Verarbeitung erforderlichen Informationen enthält.

Was ist Swagger und OpenAPI?

Swagger ist ein Open-Source-Framework zur Dokumentation und Arbeit mit OpenAPI-Dokumentation. Es kann auch zur Codegenerierung verwendet werden. OpenAPI ist ein Standard für die Beschreibung von REST-konformen API-Schnittstellen.

Tooling

  • swagger.io
    Der Swagger-Editor kann helfen, OpenApi-Spezifikationen zu visualisieren und zu entwickeln.
  • Postman
    Kann verwendet werden, um Api-Aufrufe gegen Server zu testen.

Warum REST?

  •  Es verwendet das http-Protokoll, das in fast jeder Infrastruktur verfügbar ist
  • HTTPS-Verschlüsselung kann verwendet werden
  • Geringerer Overhead als SOAP
  • Synchrone Aufrufe mit Ergebniscodes möglich, im Gegensatz zur Dateiübertragung