Download OpenAPI specification:Download
Datenaustausch mit HiOrg-Server im Format JSON:API Download Repository für Talend API Tester
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "orgakuerzel": "xxx",
- "leitung": true,
- "status": "aktiv",
- "gesperrt": false,
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "id": 12345,
- "ausbildung_id": 678910,
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07",
- "created_at": "2024-03-05T13:19:59+01:00",
- "updated_at": "2024-04-07T13:12:00+01:00"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020",
- "benutzerdefinierte_felder": [
- {
- "id": "user1",
- "name": "Führungszeugnis einfach",
- "wert": "Test 123"
}
]
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
Abfrage von Personaldaten
filter[updated_since] | string <date> Nur Personal, das seit dem angegebenen Zeitpunkt aktualisiert wurde. Datum im Format 'Y-m-dTH:i:sP'. Beispiel: 2022-07-21T17:32:28Z. Standard: nicht gesetzt. |
filter[status] | string Nur Personal, welches dem oder den angegebenen Status entspricht. Kommaseparierte Zeichenkette mit den Status. Beispiel: 'aktiv,eingeschraenkt,gesperrt,extern' |
include | string Verknüpfte Organisation, die mitgeliefert werden soll. Mögliche Werte sind z.B.: 'organisation' oder keine Angabe. |
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "orgakuerzel": "xxx",
- "leitung": true,
- "status": "aktiv",
- "gesperrt": false,
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "id": 12345,
- "ausbildung_id": 678910,
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07",
- "created_at": "2024-03-05T13:19:59+01:00",
- "updated_at": "2024-04-07T13:12:00+01:00"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020",
- "benutzerdefinierte_felder": [
- {
- "id": "user1",
- "name": "Führungszeugnis einfach",
- "wert": "Test 123"
}
]
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
]
}
Pflichtfelder sind "vorname" und "nachname"
Die Qualifikation muss über ein eindeutiges Daten-Paar identifiziert werden:
position
und rang
position
und name_kurz
zentralliste_id
und zentralliste_rang
zentralliste_id
und zentralliste_name_kurz
Zum Löschen wird der zweite Wert auf null
gesetzt.
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
required | object (user_post) Beschreibt Personal im HiOrg-Server |
{- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "leitung": true,
- "status": "aktiv",
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "orgakuerzel": "xxx",
- "leitung": true,
- "status": "aktiv",
- "gesperrt": false,
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "id": 12345,
- "ausbildung_id": 678910,
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07",
- "created_at": "2024-03-05T13:19:59+01:00",
- "updated_at": "2024-04-07T13:12:00+01:00"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020",
- "benutzerdefinierte_felder": [
- {
- "id": "user1",
- "name": "Führungszeugnis einfach",
- "wert": "Test 123"
}
]
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
Die Qualifikation muss über ein eindeutiges Daten-Paar identifiziert werden:
position
und rang
position
und name_kurz
zentralliste_id
und zentralliste_rang
zentralliste_id
und zentralliste_name_kurz
Zum Löschen wird der zweite Wert auf null
gesetzt.
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
userID required | string UserID des Personals |
required | object (user_patch) Beschreibt Personal im HiOrg-Server |
{- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "leitung": true,
- "status": "aktiv",
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "orgakuerzel": "xxx",
- "leitung": true,
- "status": "aktiv",
- "gesperrt": false,
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "id": 12345,
- "ausbildung_id": 678910,
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07",
- "created_at": "2024-03-05T13:19:59+01:00",
- "updated_at": "2024-04-07T13:12:00+01:00"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020",
- "benutzerdefinierte_felder": [
- {
- "id": "user1",
- "name": "Führungszeugnis einfach",
- "wert": "Test 123"
}
]
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
Pflichtfelder bei Neuanlage sind "vorname" und "nachname"
Die Qualifikation muss über ein eindeutiges Daten-Paar identifiziert werden:
position
und rang
position
und name_kurz
zentralliste_id
und zentralliste_rang
zentralliste_id
und zentralliste_name_kurz
Zum Löschen wird der zweite Wert auf null
gesetzt.
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
identifier_name required | string Examples:
Name des Identifizierers des Personals |
identifier_value required | string Examples:
Wert des Identifizierers des Personals |
required | object (user_put) Beschreibt Personal im HiOrg-Server |
{- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "leitung": true,
- "status": "aktiv",
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "anrede": "Herr",
- "vorname": "Max",
- "nachname": "Muster",
- "username": "admin",
- "kuerzel": "abiE",
- "telpriv": 63014618,
- "teldienst": "063014617",
- "handy": 17685214785,
- "email": "admin@example.com",
- "adresse": "Hauptstr. 3",
- "plz": "12345",
- "ort": "Musterhausen",
- "land": "Musterland",
- "gebdat": "1985-02-07",
- "gebort": "Musterhausen",
- "gruppen_namen": [
- [
- "Bereitschaft",
- "Jugend",
- "Aktive",
- "Senioren"
]
], - "orgakuerzel": "xxx",
- "leitung": true,
- "status": "aktiv",
- "gesperrt": false,
- "rechte": [
- [
- "helfer",
- "termine",
- "sandienst",
- "kurse",
- "rechnung",
- "stunden",
- "eigenestunden",
- "mitarbeiter",
- "rundnachrichten",
- "sms",
- "material",
- "forum",
- "aufgaben",
- "adressen",
- "dokumente",
- "rechnungsansicht",
- "admin"
]
], - "qualifikationen": [
- {
- "position": 1,
- "liste_id": 3529,
- "liste": "med. Qualifikation",
- "rang": 0,
- "name": "Ersthelfer",
- "name_kurz": "EH",
- "zentralliste_id": 1,
- "zentralliste_rang": 1,
- "zentralliste_name_kurz": "EH",
- "erwerb_datum": "1985-02-07"
}
], - "ausbildungen": [
- {
- "id": 12345,
- "ausbildung_id": 678910,
- "bezeichnung": "Traumatraining",
- "datum": "2024-01-07",
- "lehrgangsnummer": "12345",
- "gueltig_bis": "2026-01-07",
- "created_at": "2024-03-05T13:19:59+01:00",
- "updated_at": "2024-04-07T13:12:00+01:00"
}
], - "fahrerlaubnis": {
- "klassen": [
- "AM",
- "B",
- "B96",
- "BE",
- "L"
], - "beschraenkung": "C1 171",
- "fuehrerscheinnummer": "7B9205K0C65",
- "fuehrerscheindatum": "1995-11-01"
}, - "angehoerige": "Ehefrau Maxima Muster, Hauptstr. 3 in 12345 Musterhausen",
- "ernaehrung": [
- [
- "halal",
- "vegan"
]
], - "allerg_intol": [
- [
- "laktose",
- "soja"
]
], - "verpflegung_weiteres": "kein Spinat",
- "kontoinhaber": "Max Muster",
- "iban": "DE12 3456 7890 1234 5678 00",
- "bic": "MALEDIC",
- "kreditinstitut": "Sparkasse Musterhausen",
- "mitgliednr": "12345",
- "mitglied_seit": "01.01.1975",
- "austritt_datum": "01.01.2000",
- "wechseljgddat": "01.01.1980",
- "beruf": "Zahnarzt",
- "arbeitgeber": "Klinik in Muster",
- "bemerkung": "das ist eine Beispielbemerkung",
- "funktion": "Fachberater IuK seit 01.06.2020",
- "benutzerdefinierte_felder": [
- {
- "id": "user1",
- "name": "Führungszeugnis einfach",
- "wert": "Test 123"
}
]
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}
}
}
}
Abfrage von Personaldaten
userId required | integer UserID des Personals |
filter[updated_since] | string <date> Nur Mitglieder/Mitarbeiter, die seit dem angegebenen Zeitpunkt aktualisiert wurden. Datum im Format 'Y-m-dTH:i:sP'. Beispiel: 2022-07-21T17:32:28Z. Standard: nicht gesetzt. |
include | string Verknüpfter User, der mitgeliefert werden soll. Mögliche Werte sind z.B.: 'user' oder keine Angabe. |
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "ausbildung",
- "id": "241124",
- "attributes": {
- "bezeichnung": "Basic Life Support",
- "ausbildung_id": 12345,
- "lehrgangsnummer": "202308-BLS",
- "datum": "2023-08-06",
- "gueltig_bis": "2024-08-06",
- "updated_at": "2023-09-04T12:42:21+00:00",
- "created_at": "2023-09-04T12:42:21+00:00"
}, - "relationships": {
- "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
]
}
Löscht die AusbildungUser mit der ID {id}
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
userId required | integer UserID des Personals |
id required | integer ID der Ausbildung User |
{- "errors": [
- {
- "status": 401,
- "code": "access_denied",
- "title": "The resource owner or authorization server denied the request",
- "detail": "Missing \"Authorization\" header"
}
]
}
Abfrage von Regelmäßigen Überprüfungen
Hinweis: Das Attribut 'letze_pruefung' wird durch 'letzte_pruefung' ersetzt und zur Abwärtskompatibilität bis zum 31.01.25 weiterhin zusätzlich ausgegeben und danach entfernt.
filter[updated_since] | string <date> Nur Überprüfungen, die seit dem angegebenen Zeitpunkt geändert wurden. Datum im Format 'Y-m-dTH:i:sP'. Beispiel: 2022-07-21T17:32:28+02:00. Standard: nicht gesetzt. |
include | string Verknüpfter User, der mitgeliefert werden soll. Mögliche Werte sind z.B.: 'user' oder keine Angabe. |
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "ueberpruefung",
- "id": "24100",
- "attributes": {
- "bezeichnung": "ArbMedV - G31 Überdruck (Tauchtauglichkeitsuntersuchung)",
- "user_ignorieren": [
- {
- "status": "false",
- "ignorieren_bis": "2024-06-10"
}
], - "pruefergebnis": [
- {
- "bestanden": "true",
- "einschraenkungen": "Nur mit Brille"
}
], - "naechste_pruefung": "2024-08-01",
- "letzte_pruefung": "2023-08-01",
- "updated_at": "2023-09-04T12:42:21+00:00",
- "created_at": "2023-09-04T12:42:21+00:00"
}, - "relationships": {
- "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
]
}
Abfrage von Ehrungen zu einem Personal
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "ehrung",
- "id": "24100",
- "attributes": {
- "bezeichnung": "Großes Ehrenzeichen",
- "ehrung_jahre": 25,
- "eigene_ehrung_id": 555898,
- "verliehen_am": "2022-08-01",
- "bemerkung": "Insgesamt die 3. Ehrung"
}, - "relationships": {
- "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
]
}
Abfrage der Stammdaten der eigenen Organisation
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "orga",
- "id": "14119",
- "attributes": {
- "kuerzel": "xxx",
- "bezeichnung": "Hilfsorganisation Musterstadt e.V.",
- "anschrift": "Am Markt 12",
- "anschrift2": "",
- "plz": "66386",
- "ort": "Sankt Ingbert",
- "emailAllgemein": "papierkorb@hiorg-server.de",
- "emailDienste": "papierkorb@hiorg-server.de",
- "ansprechpartnerDienste": "Heiner Meiser"
}
}
}
OAuth: Infos zum eigenen Benutzer abfragen
Dieser Endpunkt wird in der OAuth2-Spezifikation beschrieben.
{- "sub": "9aabc46f91700bf0d97f625b7c5eeacf",
- "name": "Max Muster",
- "given_name": "Max",
- "family_name": "Muster",
- "preferred_username": "admin",
- "email": "admin@example.com",
- "email_verified": false,
- "gender": "male",
- "birthdate": "1985-08-12T00:00:00.000Z",
- "phone_number": "0171-12345679",
- "phone_number_verified": false,
- "address": {
- "formatted": "Max Muster\nEnsheimerstr. 12\n66386 St. Ingbert\nDeutschland",
- "street_address": "Ensheimerstr. 12",
- "locality": "St. Ingbert",
- "postal_code": "66386",
- "country": "Deutschland"
}, - "updated_at": 1572214287
}
Ruft einen iCal-Feed eines privaten Kalenders ab
hash required | string Examples:
Hash des privaten Kalender-Feeds |
BEGIN:VCALENDAR VERSION:2.0 CALSCALE:GREGORIAN PRODID:-//HiOrg-Server.de//NONSGML HiOrg-Server//EN X-LOTUS-CHARSET:UTF-8 X-WR-TIMEZONE:Europe/Berlin X-WR-CALNAME:HiOrg-Server XXX X-WR-CALDESC:HiOrg-Server XXX BEGIN:VEVENT UID:9719886-8955843@xxx.hiorg-server.de CATEGORIES:HiOrg-Server TRANSP:OPAQUE CLASS:PUBLIC SEQUENCE:0 DTSTAMP:20201015T124946Z DTSTART:20201218T170000Z DTEND:20201218T190000Z SUMMARY:Dienstabend LOCATION: ORGANIZER:mailto:papierkorb@hiorg-server.de DESCRIPTION:Treffpunkt: Vereinsheim END:VEVENT BEGIN:VEVENT UID:9704352-8938947@xxx.hiorg-server.de CATEGORIES:HiOrg-Server TRANSP:OPAQUE CLASS:PUBLIC SEQUENCE:0 DTSTAMP:20201015T124946Z DTSTART:20201222T140000Z DTEND:20201222T180000Z SUMMARY:Sanitätsdienst: Jahresendveranstaltung LOCATION:Stadthalle Musterhausen ORGANIZER:mailto:papierkorb@hiorg-server.de END:VEVENT END:VCALENDAR
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "kalender",
- "id": "1234",
- "attributes": {
- "bezeichnung": "Kalender 1",
- "client": "hiorg_sample_client",
- "termine": true,
- "dienste": true,
- "kurse": true,
- "nurEigene": true,
- "createdAt": "2020-01-01T08:00:00+02:00",
- "createdByClient": "2020-01-01T16:00:00+02:00"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}, - "personal": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
]
}
Erstellt einen neuen Kalender
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
required | object (kalender_post) JSON API Kalender-Resource |
{- "data": {
- "type": "kalender",
- "id": "1234",
- "attributes": {
- "bezeichnung": "Kalender 1",
- "termine": true,
- "dienste": true,
- "kurse": true,
- "nurEigene": true
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "kalender",
- "id": "1234",
- "attributes": {
- "bezeichnung": "Kalender 1",
- "client": "hiorg_sample_client",
- "termine": true,
- "dienste": true,
- "kurse": true,
- "nurEigene": true,
- "createdAt": "2020-01-01T08:00:00+02:00",
- "createdByClient": "2020-01-01T16:00:00+02:00"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}, - "personal": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
Ruft Informationen zum Kalender mit der ID {id} ab
id required | integer Examples:
ID des Kalenders |
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "kalender",
- "id": "1234",
- "attributes": {
- "bezeichnung": "Kalender 1",
- "client": "hiorg_sample_client",
- "termine": true,
- "dienste": true,
- "kurse": true,
- "nurEigene": true,
- "createdAt": "2020-01-01T08:00:00+02:00",
- "createdByClient": "2020-01-01T16:00:00+02:00"
}, - "relationships": {
- "organisation": {
- "data": {
- "type": "orga",
- "id": "14119"
}
}, - "personal": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
EntferntKalender mit der ID {id}
id required | integer Examples:
ID des Kalenders |
{- "errors": [
- {
- "status": 401,
- "code": "access_denied",
- "title": "The resource owner or authorization server denied the request",
- "detail": "Missing \"Authorization\" header"
}
]
}
filter[eigene] | boolean Nur die eigenen Helferstunden ausgeben. Standard: true |
filter[von] | string <date> Nur Helferstunden, deren Anfang oder Ende nach dem angegebenen Datum liegen. Datum im Format 'Y-m-d'. Standard: vor 6 Monaten |
filter[bis] | string <date> Nur Helferstunden, deren Anfang oder Ende vor dem angegebenen Datum liegen. Datum im Format 'Y-m-d'. Standard: leer |
filter[changed_since] | string <date> Nur Helferstunden, die seit dem angegebenen Zeitpunkt aktualisiert wurden. Datum im Format 'Y-m-dTH:i:sP'. Beispiel: 2022-07-21T17:32:28Z. Standard: nicht gesetzt. |
include | string Verknüpfte Objekte, die mitgeliefert werden sollen(als Kommaseparierte Liste). Mögliche Werte sind z.B.: 'anlass', 'typ', 'user' oder 'anlass.referenz'. 'anlass.referenz' referenziert hier die Veranstaltung bzw. Aufgabe mit der der Anlass verknüpft ist. Hinweis: Referenzen werden derzeit nur für Helferstunden zu einem Dienst oder Termin ausgeben, welche dann den Ort der Veranstaltung enthalten. |
{- "jsonapi": {
- "version": "1.0"
}, - "data": [
- {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "freigegeben": true,
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5,
- "created_at": "2020-01-01T16:00:00+01:00",
- "updated_at": "2020-01-01T19:00:00+01:00"
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
]
}
Legt neuen Helferstunden-Eintrag an
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
required | object (helferstunden_post) Helferstunden-Eintrag eines Nutzers zu einem Anlass |
{- "data": {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "freigegeben": true,
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5,
- "created_at": "2020-01-01T16:00:00+01:00",
- "updated_at": "2020-01-01T19:00:00+01:00"
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
Ruft Informationen zum Helferstunden-Eintrag mit der ID {id} ab
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
id required | integer ID des Helferstunden-Eintrags |
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "freigegeben": true,
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5,
- "created_at": "2020-01-01T16:00:00+01:00",
- "updated_at": "2020-01-01T19:00:00+01:00"
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
Löscht den Helferstunden-Eintrag mit der ID {id}
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
id required | integer ID des Helferstunden-Eintrags |
{- "errors": [
- {
- "status": 403,
- "code": "permission_denied",
- "title": "Zugriff nicht erlaubt",
- "detail": "Admin-Rechte im Account erforderlich zur Abfrage dieser Daten"
}
]
}
ändert einen Helferstunden-Eintrag
id required | integer ID des Helferstunden-Eintrags |
required | object (helferstunden_patch) Helferstunden-Eintrag eines Nutzers zu einem Anlass |
{- "data": {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden",
- "id": "1234",
- "attributes": {
- "freigegeben": true,
- "von": "2020-01-01T08:00:00+02:00",
- "bis": "2020-01-01T16:00:00+02:00",
- "stunden": 7.5,
- "anfahrt_km": 8,
- "freies_zahlenfeld": 3.5,
- "created_at": "2020-01-01T16:00:00+01:00",
- "updated_at": "2020-01-01T19:00:00+01:00"
}, - "relationships": {
- "anlass": {
- "data": {
- "type": "helferstunden_anlass",
- "id": "1234"
}
}, - "typ": {
- "data": {
- "type": "helferstunden_typ",
- "id": "12"
}
}, - "user": {
- "data": {
- "type": "user",
- "id": "9aabc46f91700bf0d97f625b7c5eeacf"
}
}
}
}
}
Speichert einen Anlass für Helferstunden
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
required | object (helferstunden_anlass_post) Ein Anlass zu dem mehrere Helferstunden gespeichert werden können (z.B. ein Dienstzeitraum oder freie Helferstunden) |
{- "data": {
- "type": "helferstunden_anlass",
- "id": "1234",
- "attributes": {
- "beschreibung": "Sanitätsdienst",
- "typ": "dienst"
}, - "relationships": {
- "dienst": {
- "data": {
- "type": "dienst",
- "id": "123"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden_anlass",
- "id": "1234",
- "attributes": {
- "beschreibung": "Sanitätsdienst",
- "typ": "dienst"
}, - "relationships": {
- "dienst": {
- "data": {
- "type": "dienst",
- "id": "123"
}
}
}
}
}
Ändert einen Anlass für Helferstunden
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
id required | integer Id des Anlasses |
required | object (helferstunden_anlass_patch) Ein Anlass zu dem mehrere Helferstunden gespeichert werden können (z.B. ein Dienstzeitraum oder freie Helferstunden) |
{- "data": {
- "type": "helferstunden_anlass",
- "id": "1234",
- "attributes": {
- "beschreibung": "Sanitätsdienst",
- "typ": "dienst"
}, - "relationships": {
- "dienst": {
- "data": {
- "type": "dienst",
- "id": "123"
}
}
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden_anlass",
- "id": "1234",
- "attributes": {
- "beschreibung": "Sanitätsdienst",
- "typ": "dienst"
}, - "relationships": {
- "dienst": {
- "data": {
- "type": "dienst",
- "id": "123"
}
}
}
}
}
Gibt Helferstunden-Einstellungen bezogen auf den eigenen Nutzer zurück
DRAFT: Die API befindet sich derzeit noch in der Entwicklung. Daher kann es sein, dass sich die Spezifikation noch ändert.
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "helferstunden_einstellungen",
- "id": "1234",
- "attributes": {
- "nutze_anfahrt_km": true,
- "anfahrt_km_default": 10,
- "nutze_freies_zahlenfeld": true,
- "feldname_freies_zahlenfeld": "Spesen",
- "rundung_minuten": 30
}, - "relationships": {
- "typen": {
- "data": [
- {
- "type": "helferstunden_typ",
- "id": "12"
}
]
}
}
}, - "included": [
- {
- "type": "helferstunden_typ",
- "id": "12",
- "attributes": {
- "bezeichnung": "sandienst"
}
}
]
}
{- "jsonapi": {
- "version": "1.0"
}, - "meta": {
- "size": 0
}, - "data": [
- {
- "type": "benachrichtigung",
- "id": "123-9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "erstellt_am": "2020-01-01T08:00:00+02:00",
- "gelesen_am": "2020-01-01T12:30:00+02:00",
- "text": "Für Dienst 'Sandienst' am 01.05.2021 werden noch Helfer benötigt. Bitte prüfen sie, ob sie sich zu dem Dienst melden können.",
- "tags": [
- [
- "dienst",
- "rechnung"
]
], - "aktion": {
- "typ": "create_rechnung_kurs",
- "text": "Rechnung erstellen"
}
}
}
]
}
löscht eine Benachrichtigung
id required | string Examples:
kombinierte Id aus Benachrichtigung und Empfaenger |
{- "errors": [
- {
- "status": 400,
- "code": "DATA_MEMBER_MISSING",
- "title": "Missing `data` member at the document's top level",
- "detail": "Missing `data` member at the document's top level"
}
]
}
ändert eine Benachrichtigung
id required | string Examples:
kombinierte Id aus Benachrichtigung und Empfaenger |
required | object (benachrichtigung_patch) Benachrichtigung eines Nutzers |
{- "data": {
- "type": "benachrichtigung",
- "id": "123-9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "gelesen": true
}
}
}
{- "jsonapi": {
- "version": "1.0"
}, - "data": {
- "type": "benachrichtigung",
- "id": "123-9aabc46f91700bf0d97f625b7c5eeacf",
- "attributes": {
- "erstellt_am": "2020-01-01T08:00:00+02:00",
- "gelesen_am": "2020-01-01T12:30:00+02:00",
- "text": "Für Dienst 'Sandienst' am 01.05.2021 werden noch Helfer benötigt. Bitte prüfen sie, ob sie sich zu dem Dienst melden können.",
- "tags": [
- [
- "dienst",
- "rechnung"
]
], - "aktion": {
- "typ": "create_rechnung_kurs",
- "text": "Rechnung erstellen"
}
}
}
}
typ | string Typ des referenzierten Objekts: 'd für Dienst', 't für Termin', 'k für Kurs', 'm für Material', 'u für Personal' |
id | string ID des referenzierten Objekts, wobei beim Personal 'u' die User-ID verwendet wird, z.B. u=9aabc46f91700bf0d97f625b7c5eeacf, für Dienst/Termin/Kurs/Material z.B. d=9557967 |
[- {
- "titel": "Karteikarte",
- "aktion": {
- "typ": "show_formular",
- "text": "zum Formular",
- "data": {
- "formid": "meldekarte",
- "rt": "u",
- "ri": "9aabc46f91700bf0d97f625b7c5eeacf",
- "ovx": "xxx"
}
}
}
]