Externe Aktivitäten¶
Externe Systeme können, mit den notwendigen Berechtigungen, Benachrichtigungen für Benutzer erzeugen.
Externe Aktivität erzeugen (POST)¶
-
POST
/@external-activities
¶ Erzeugt eine externe Aktivität und damit eine Benachrichtigung an den angegebenen Benutzer.
Die in
notification_recipients
angegebene Liste muss genau dem Benutzer entsprechen, mit welchem der Request authentisiert ist. Es ist also nicht erlaubt, Benachrichtigungen an andere Benutzer auszulösen, sondern nur an sich selbst.Dies setzt dementsprechend voraus, dass die externe Applikation als vertrauenswürdig eingestuft wurde, und GEVER so konfiguriert ist, von dieser Applikation Requests im Kontext des Benutzers zu erlauben.
Beim Aufrufen einer solchen Benachrichtigung wird der Benutzer zu der in
resource_url
angegebenen URL weitergeleitet.Request:
POST /@external-activities HTTP/1.1 Accept: application/json Content-Type: application/json { "notification_recipients": ["john.doe"], "resource_url": "https://external.example.org/", "title": { "de": "Ein Ereignis ist eingetreten", "en": "An event happened" }, "label": { "de": "...", "en": "..." }, "summary": { "de": "...", "en": "..." }, "description": { "de": "...", "en": "..." } }
Response:
HTTP/1.1 201 Created Content-Type: application/json { "activity": { "actor_id": "__system__", "actor_label": "System", "created": "2021-12-09T10:16:00+00:00", "label": "...", "summary": "...", "title": "..." } }