HttpGateway-APP

HttpGateway-APP

 Funktionsumfang der HttpGateway-App

Die HttpGateway-App ist die zentrale HTTP-Schnittstelle zu allen Apps der d.velop cloud.

Durch die Verwendung der HttpGateway-App werden alle Anwendungen in der d.velop cloud über eine gemeinsame Basisadresse per HTTPS bereitgestellt. Dadurch können Anwendungen, die auf verschiedenen Servern laufen, aus Anwendersicht über eine zentrale Anlaufstelle erreicht werden. Die HttpGateway-App implementiert darüber hinaus das d.velop Mandantenkonzept wie in den Basics beschrieben.

Die HttpGateway-App stellt außerdem eine API-Schnittstelle bereit, die den Zugriff durch Apps erlaubt. Dies erlaubt es Apps zum Beispiel automatisch zu erkennen, welche anderen Apps installiert sind und mit diesen Apps zu kommunizieren, auch wenn diese zur Bereitstellung der App noch nicht bekannt waren.

 Verwenden der API-Funktionen

Nachfolgend erfährst du, wie du die Programmierschnittstelle der HttpGateway-App für eigene Entwicklungen nutzen kannst.

 Auflisten der gebuchten Apps

Die URL zum Auflisten der gebuchten Apps ist als Linkrelation in der Antwort einer GET-Anforderung an die HttpGateway-App zu finden:

Request

       GET /httpgateway
Accept: application/hal+json

Response

   {
    "_links":{
        "apps":{
          "href": "/httpgateway/conf/apps"
        }
    }
}

Folge der Linkrelation mit dem Namen apps.

Request

       GET /httpgateway/conf/apps
Accept: application/hal+json

Response

   {
	"apps": [
		{ "app": "config" },
		{ "app": "home" },
		{ "app": "httpgateway" },
		{ "app": "identityprovider" },
		{ "app": "shell" },
		{ "app": "task" },
		{ "app": "usermanagement" }
	]
}

  • In der Antwort findest du ein Array mit dem Namen apps. Dieses Array enthält einen Eintrag für jede gebuchte App.
  • Die Eigenschaft app enthält den App-Namen.

Die von der HttpGateway-App aufgelisteten App sind immer unter https://_Basisadresse_/_Appname_ zu erreichen.