Allgemein: System-Interaktion per HTTP (REST API).

Sie können Partner per HTTP suchen, anlegen, ändern und löschen.

Jeder Request erfordert eine Authentifizierung über Basic Authentication (Benutzername und Passwort eines Lobster_data-Benutzers mit dem Benutzer-Recht Administrator oder Administration via REST). Alternativ zu Basic Authentication können die Benutzerdaten in der URL mit &user=myuser&passwd=mypassword übergeben werden.

Logs für Anfragen dieser Art finden Sie in den Server-Logs unter internal/message.log.

Partner suchen

Über den Namen eines Partners wird dessen ID zurück gegeben.

URL (HTTP GET):

http://<IP oder URL des Integration Servers>/dw/auth/v1/relationSearch?name=<Partnername>

https://<IP oder URL des Integration Servers>/dw/auth/v1/relationSearch?name=<Partnername>

Hinweis: Siehe Abschnitt Hinzufügen eines HTTPS-Listeners.

Beispielhafte Response

Die Struktur der Response ist bei jeder erfolgreichen Partner-Operation identisch.

Die id ist die Partner-ID.

{
    "response": {
        "status": "ok",
        "id": "1554894544117000"
    }
}

Partner anlegen

URL (HTTP POST mit JSON):

http://<IP oder URL des Integration Servers>/dw/auth/v1/relation

https://<IP oder URL des Integration Servers>/dw/auth/v1/relation

JSON:

{
	"operation": "add",
	"id": 0,
	"name": "My partner",
	"active": true
}

Sie können hier entweder 0 für die id angeben oder die Zeile ganz weglassen, da die ID bei dieser Operation ja erst erzeugt wird.

Mit name wird der Name des zu erzeugenden Partners festgelegt.

Mit active können Sie den Partner aktiv oder inaktiv setzen.

Partner ändern

URL (HTTP POST mit JSON):

http://<IP oder URL des Integration Servers>/dw/auth/v1/relation

https://<IP oder URL des Integration Servers>/dw/auth/v1/relation

JSON:

{
    "operation": "update",
    "id": 1616381046459001,
	"name": "My partner updated",
	"active": false
}

Partner löschen

URL (HTTP POST mit JSON):

http://<IP oder URL des Integration Servers>/dw/auth/v1/relation

https://<IP oder URL des Integration Servers>/dw/auth/v1/relation

JSON:

{
    "operation": "delete",
    "id": 1616381046459001
}