Datenmodell aus XML Schema (XSD)
Das Datenmodell als XML Schema (XSD Datei) für die ITscope Datenformate kann über die interaktive API über die API Methode info abgerufen werden. Für diesem Abruf wird kein API Key benötigt. Als URL Pfad wird einfach das Datenausgabeformat gesetzt.
URL zur Schemadefinition für das Datenausgabeformat standard:
https://api.itscope.com/2.1/info/schema/standard.xsd
URL zur Schemadefinition für das Datenausgabeformat standardUpdate:
https://api.itscope.com/2.1/info/schema/standardupdate.xsdAnleitung für Java
Das Ergebnis des API Abrufs für das Schema je nach Datenformat, also die XML Definition kann dann lokal auf die Festplatte gespeichert werden z.B. unter c:\temp\itscope_api.xsd
Über den Binding Compiler von Java (xjc.exe) kann nun anhand der XML Definition ein Java Klassen Modell erstellt werden.
Dieser Aufruf erzeugt ein Package mit dem Namen de.itscope.api.
„c:\Program Files\Java\jdk1.7.0_51\bin\xjc.exe“ -p de.itscope.api c:\temp\itscope_api.xml
Anleitung für C#, .NET und VB.NET
Hierbei handelt es sich nur um Beispieltools oder Anleitungen zum Thema Scheme Generierung.
- XML Schema Definition-Tool (Xsd.exe) direkt in VisualStudio. Anleitung siehe https://msdn.microsoft.com/de-de/library/x6c1kb0s%28v=vs.120%29.aspx
oder hier https://msdn.microsoft.com/en-us/library/x6c1kb0s%28v=VS.100%29.aspx
API Client für verschiedene Entwickler-Sprachen
API Clients können anhand der von ITscope ausgegebenen openAPI-Spezifikation generiert werden. Dies erzeugt notwendige API-Datenmodelle sowie API-Dokumentation. Diese Clients sollen als Gerüst für eine Anwendung dienen, das Arbeit ersparen soll, aber noch keinen vollständigen Client abgibt. D.h. individuelle Anpassung werden nötig sei. Sollte das Format XML genutzt werden, muss noch eine Funktion zum Deserialisieren eines XML Strings implementiert werden.
Mithilfe des openapi-generator kann auf einfache Art und Weise ein Client in verschiedenen Sprachen übersetzt werden.
openapi-generator generate -i https://api.itscope.com/2.1/openapi.json -g java -o ./clientPostman
Für die Nutzer von Postman haben wir ein Projekt erstellt, welches alle Endpunkte unserer API-Version 2.1 enthält. Die Requests sind in Postman dokumentiert.
Postman kann hier heruntergeladen werden.
Nach dem Download werden Sie von Postman gefragt, ob Sie sich registrieren möchten. Sie können die Registrierung aber auch überspringen: „Skip signing in and take me straight to the app“
Der Download des Postman Projekts befindet sich am Ende dieser Seite.
Im Postman wählen Sie ein Workspace aus und drücken auf Import.
Folgende Variablen sind bereits in Postman angelegt und können mit Ihren API Zugangsdaten befüllt werden.
| Variable | Beschreibung | Beispiel |
| baseUrl | Die ITscope API Url und Version | https://api.itscope.com/2.1 |
| Account_ID | Die ITscope Account-ID (als Nutzername) | m123456 |
| API_KEY | Der API-Key (als Passwort) | abc123de_f456… |
Speichern Sie die Variablen ab. Postman wäre somit startklar.