Select

Abruf von Auswahllisten – sowohl die systemseitigen Listen als auch selbst angelegte Felddefinitionen. Die verfügbaren Listen-Keys liefert selectgroup/getall.

Alle Auswahllisten abrufen

POST KUNDEN-HMAC /selectgroup/getall

Liefert alle verfügbaren Auswahllisten – die systemseitigen sowie die selbst angelegten Felddefinitionen.

Response

Array der Auswahllisten-Gruppen inkl. der Keys, die für select/getall/{key} verwendet werden:

[
  {
    "select_group_key": "sachgebiet",
    "select_group_name": "Sachgebiet",
    "select_group_update": "2025-11-06 19:04:42",
    "select_group_copyright": "",
    "select_group_source": "GDS.Sachgebiet_2.3.json"
  },
  {
    "select_group_key": "salutation",
    "select_group_name": "Anrede",
    "select_group_update": "2024-05-16 13:38:19",
    "select_group_copyright": "",
    "select_group_source": ""
  },
  {
    "select_group_key": "sendungsprioritaet",
    "select_group_name": "Sendungsprioritaet",
    "select_group_update": "2025-11-06 12:19:23",
    "select_group_copyright": "",
    "select_group_source": "GDS.Sendungsprioritaet_1.2.json"
  }
]

Feld	Typ	Beschreibung
select_group_key	string	Key der Liste – wird als {select_group_key} in select/getall verwendet
select_group_name	string	Anzeigename der Liste
select_group_update	string	Zeitpunkt der letzten Änderung (YYYY-MM-DD HH:MM:SS)
select_group_copyright	string	Copyright-Hinweis (kann leer sein)
select_group_source	string	Quell-Schema der Liste (kann leer sein)

Mögliche Fehler

Code	Meldung	Bedingung
404	select groups could not be found	Keine Listen vorhanden
403	access denied	HMAC-Signatur ungültig oder abgelaufen, hmac_unique wiederverwendet oder Origin nicht freigegeben
500	–	Interner Fehler – generische Meldung
503	–	Rate-Limit überschritten (250 Requests/s pro IP)

Werte einer Auswahlliste abrufen

POST KUNDEN-HMAC /select/getall/{select_group_key}

Liefert alle Einträge einer bestimmten Auswahlliste.

Pfad-Parameter

Parameter	Beispiel	Beschreibung
select_group_key	bestandteiltyp	Key der Liste, z. B. bestandteiltyp

Response

Array der Listeneinträge – Beispiel für salutation:

[
  {
    "select_item_ident": "salutation-x",
    "select_group_item_title": "divers"
  },
  {
    "select_item_ident": "salutation-w",
    "select_group_item_title": "Frau"
  },
  {
    "select_item_ident": "salutation-m",
    "select_group_item_title": "Herr"
  },
  {
    "select_item_ident": "salutation-a",
    "select_group_item_title": "keine Angabe"
  }
]

Feld	Typ	Beschreibung
select_item_ident	string	Eindeutiger Key des Eintrags – wird in Datenfeldern referenziert
select_group_item_title	string	Anzeigename des Eintrags

Mögliche Fehler

Code	Meldung	Bedingung
403	access denied	HMAC-Signatur ungültig oder abgelaufen, hmac_unique wiederverwendet oder Origin nicht freigegeben
500	–	Interner Fehler – generische Meldung
503	–	Rate-Limit überschritten (250 Requests/s pro IP)