Das Zusammenspiel URL, Zertifikat sieht wie folgt aus:
Zertifikat
IIS Server Zertifikat
IIS HTTPS Binding
Url
Swagger ist eine Schnittstellendokumentation, welche alle verfügbaren Ressourcen aufzeigt und gleichzeitig dessen «LIVE» Ausführung erlaubt.
Um Swagger zu verwenden, müssen Sie zuerst einen Infoniqa ONE 200 Benutzer mit Infoniqa Cloud Identity verknüpfen. Bitte lesen Sie dazu den Abschnitt Infoniqa Cloud Identity.
Swagger Redirect URL
Damit Sie die Anmeldung beim Swagger korrekt abschliessen können, müssen Sie uns noch die folgenden Informationen per E-Mail (OrderSchweiz@infoniqa.com) mitteilen.
Beispiel-Mailtext:
Webseite, welche Sie bei der Installation angegeben haben: API
Produkt: Infoniqa Produktname (Infoniqa 50 oder Infoniqa ONE 200)»
Sobald wir die Angaben eingetragen haben, teilen wir Ihnen diese mit. Wenn Sie die Redirect URL von uns erhalten haben, gehen Sie bitte wie folgt vor:
-
Wechseln Sie in den Ordner wo die REST-Api installiert wurde. Am besten über den IIS und im Context Menue «Im Explorer öffnen» auswhälen.
-
Im File Explorer die Datei appsettings.json auswählen und im Editor öffnen.
-
Tragen Sie nun im json File die URL beim Element SCI => InternalRedirect ein.
Speichern Sie die Datei und starten Sie ggf. den IIS neu.
Danach sind Sie in der Lage, sich auf der Swagger Seite mit dem verknüpften SCI Benutzer anzumelden.
Authentifizierung
Um die Ressourcen ausführen zu können, müssen man sich mit seiner E-Mail-Adresse anmelden. Dazu wird die Schaltfläche «Authorize» betätigt.
Es wird ein kleines Fenster mit den verfügbaren Autorisierungen angezeigt.
In diesem Fall wird das Kontrollkästchen «readwrite_access / Allow to read/write» aktiviert und mit «Authorize» bestätigt. Es wird das Infoniqa Cloud Identity Fenster geöffnet. Hier fährt man mit der registrierten E-Mail-Adresse weiter.
Ressourcen Übersicht
Auf der Hauptseite sind die verfügbaren Ressourcen ersichtlich.
Im unteren Bereich werden die verschiedenen Models (DTOs) angezeigt.
Um eine bestimmte Ressource zu verwenden, klickt man auf die dazugehörige Überschrift (Beispiel Kreditor).
Links wird angezeigt, um welche Funktionalität es sich handelt:
-
GET (Lesen)
-
POST(Schreiben/Hinzufügen)
-
PUT (Updaten einer bestehenden Ressource)
Rechts wird der Methodenname dargestellt.
Ressourcen Aufruf
Die entsprechende Funktion klicken und mittels «Try it out» gelangt man in den «Ausführung Modus».
Die benötigten Parameter abfüllen und «Execute» betätigen.
Im «Response» Bereich wird das Resultat im JSON Format zurückgegeben.