Was kann der API-Key alles?
Mit dem API-Key kann sich ein externes System gegenüber den Systemen der DRK Service GmbH als "Ihr Kreisverband" ausweisen. Wenn Sie Kurse über z.B. HiOrg-Server oder LEO verwalten, dann können deren Server in Ihrem Namen diese Kurs auch für Sie in der Dienstleistungsdatenbank hinterlegen.
Beim DRKCMS dient der API-Key dazu, die sog. "KDB-Formulare" zu steuern, konkret für Fördermitgliedschaften, Kursterminanmeldung (wenn Sie das KTV-Modul nutzen) oder das Kontaktformular. Einerseits weiß das DRKCMS so, wer Sie sind (z.B. zeigt es Ihren Gliederungsnamen beim SEPA-Lastschriftmandat an), andererseits landen die Anfragen in Ihrer Instanz der KDB.
Mehr Informationen zu den einzelnen Formular-Typen im DRKCMS finden Sie in folgendem Hilfeartikel: https://ticket.dt-internet.de/help/de-de/17/566-verschiedene-formular-typen-im-drkcms
Der API-Key ist nicht nötig für die reine Anzeige von Kursterminen, Kleidercontainer-Standorten oder sonstigen Inhalten aus der DLDB. Diese "öffentlichen" Angaben werden rein über den Kreisverbands-Namen (oder bei Suchen z.B. über die PLZ) abgefragt.
Wo bekomme ich den API-Key her?
Der API-Key wurde vor einigen Jahren von der DRK Service GmbH für Ihren Kreisverband generiert und Ihnen zugeschickt. Wenn Sie den nicht mehr kennen, finden Sie ihn in der "Benutzerverwaltung" der DRK Service GmbH, konkret siehe folgendes Handbuch: https://handbuch.drk-intern.de/books/bvw/page/api-key
API-Keys bekommen in der Regel nur Kreisverbände und Gliederungen oberhalb. Als Ortsverein könnten Sie den API-Key Ihres KVs erfragen und nutzen, allerdings setzt das einerseits voraus, dass Ihr KV einverstanden ist, dass Sie in seinem Namen Daten in die DLDB etc. eintragen können. Und umgekehrt muss Ihr KV dann auch die Anfragen (Transfertickets, Buchungen, ...) verarbeiten.
Unter bestimmten Voraussetzungen können/konnten auch Ortsvereine einen eigenen Zugang zur KDB bekommen, weitere Informationen erhalten Sie bei Bedarf bei der DRK Service GmbH.
Wo trage ich den API-Key ein?
Am einfachsten: Direkt bei der Installation. Unser Assistent fragt danach und trägt den anschließend an allen relevanten Stellen für Sie ein. Wenn Sie das nachträglich ändern/nachholen wollen, können Sie das in der Site-Configuration:
Gehen Sie dazu ins Modul "Sites", dort finden Sie i.d.R. (und bei der Betriebsart "rolling updates": hoffentlich) einen einzigen Eintrag. Den öffnen Sie mit dem Stift.
Nun gehen Sie in den Reiter "DRK Funktionen", dort finden Sie ein Feld für den API-Schlüssel. Eintragen, Speichern, und dann oben rechts mit dem Blitz den Frontend-/Seiteninhalts-Cache leeren.
Theoretisch gibt es auch noch Eingabefelder im Bereich der Konstanten. Diese werden, soweit wir wissen, nicht mehr ausgewertet. Mehr zum "Konflikt" zwischen SiteConfig und Konstanten haben wir in folgendem Hilfeartikel beschrieben: https://ticket.dt-internet.de/help/de-de/16/545-grundkonfiguration-sites-modul-vs-fruhere-templates-seit-version-12