...
Folgende Header müssen in der Anfrage gesetzt werden:
Header | Wert |
---|---|
Authorization | Zugriffsschlüssel der Organisation |
Content-Type | application/json |
Datenformat
Als Datenformat kommt JSON zum Einsatz. Im Feld type
kann die Art der Nachricht gewählt werden. Hier sind die Werte ALARM
oder INFO
zulässig. Mit den Typ INFO
wird ein Info-Alarm bei der Person ausgelöst. Optional können Farbe (color
) für die Anzeige der Nachricht in aPager und die Koordinaten (lat
und lng
) gesetzt werden.
Codeblock | ||
---|---|---|
| ||
{ "type": "ALARM", "title": "Titel der Nachricht", "color": "#FE2E2E", "message": "Textinhalt der Nachricht", "group": "Alarmgruppenname", "lat": 48.35512, "lng": 10.903633, "withFeedback": false, "externalId": "68bcca1d-3dc9-403f-94c5-b17679af6aef", "customFeedbackName":"Meine Rückmeldeoptionen", "expiresHours": 24 } |
Datenfelder
Feld | Bedeutung | Pflichtfeld | ||||||
---|---|---|---|---|---|---|---|---|
| Typ der Nachricht (ALARM, INFO) | Ja | ||||||
| Titel der Nachricht | Ja | ||||||
| Farbe der Nachricht | Ja | ||||||
| Inhalt | Ja | ||||||
| Einheitenkennung | Ja | ||||||
| Koordinaten des Einsatzortes | Ja | ||||||
| Ja | |||||||
| Ob der Alarm Rückmeldungen enthalten soll | Nein | ||||||
| Anzahl in Stunden, bis der Alarm automatisch aus aPager PRO gelöscht wird | Nein |
Rückmeldungen funktionieren nur in Organisationen, welche einen aktiven Online-Service haben.
Return-Codes
Return-Code | |||||||
---|---|---|---|---|---|---|---|
200 | Alarmierung der Person erfolgreich | ||||||
400 | Das Mappen des JSON ist fehlgeschlagen | ||||||
401 | Falscher oder ungültiger Zugriffsschlüssel oder Personen ID übergeben. | ||||||
403
| Wenn eine synchronisierte Person in FE2 blockiert wurde | ||||||
404 | keine Person zur Alarmierung gefunden. | ||||||
429 | maximale Anzahl der Anfragen für Intervall überschritten. Das Limit beträgt 60 Anfragen pro Minute | ||||||
503 | Organisation hat die Synchronisation und Personenalarm nicht aktiv |
Alarmierung von mehreren Personen gleichzeitig
...
Folgende Header müssen in der Anfrage gesetzt werden:
Header | Wert |
---|---|
Authorization | Zugriffsschlüssel der Organisation |
Content-Type | application/json |
Datenformat
Als Datenformat kommt JSON zum Einsatz. Im Feld type
kann die Art der Nachricht gewählt werden. Hier sind die Werte ALARM
oder INFO
zulässig. Mit den Typ INFO
wird ein Info-Alarm bei der Person ausgelöst. Optional können Farbe (color
) für die Anzeige der Nachricht in aPager und die Koordinaten (lat
und lng
) gesetzt werden.
...
Codeblock | ||
---|---|---|
| ||
{ "type": "ALARM", "title": "Titel der Nachricht", "color": "#FE2E2E", "message": "Textinhalt der Nachricht", "group": "Alarmgruppenname", "lat": 48.35512, "lng": 10.903633, "personIds":[ "1d196821-b24e-460e-8ac2-5de36b73ea76", "2422d3a5-c81d-4cbc-8f6b-858bf842bd45" ] } |
Return-Codes
Return-Code | |||||||
---|---|---|---|---|---|---|---|
200 | Alarmierung der Person erfolgreich | ||||||
400 | Das Mappen des JSON ist fehlgeschlagen | ||||||
401 | Falscher oder ungültiger Zugriffsschlüssel oder Personen ID übergeben. | ||||||
403
| Wenn eine synchronisierte Person in FE2 blockiert wurde | ||||||
404 | keine Person zur Alarmierung gefunden. | ||||||
429 | maximale Anzahl der Anfragen für Intervall überschritten. Das Limit beträgt 60 Anfragen pro Minute | ||||||
503 | Organisation hat die Synchronisation und Personenalarm nicht aktiv |
Abruf von Personen
Damit Sie Personen anhand derer ID alarmieren können, müssen Sie diese zuerst kennen. Über diese Schnittstelle können Sie alle Personen abrufen und erhalten die ID für die Alarmierung. (Ab Version
Status | ||||
---|---|---|---|---|
|
...
Folgende Header müssen in der Anfrage gesetzt werden:
Header | Wert |
---|---|
Authorization | Zugriffsschlüssel der Organisation |
Content-Type | application/json |
Rückgabewert
Als Datenformat kommt JSON zum Einsatz. Sie erhalten eine Liste von allen Personen, deren Namen und internen und ggf. externen IDs.
...