API-Schlüssel erstellen #
Um einen neuen API-Schlüssel hinzuzufügen, gehe wie folgt vor:
- «Organisation / Einstellungen / API-Schlüssel».
- Klicke auf «API-Schlüssel hinzufügen».
- Füge einen Namen hinzu, um den Schlüssel später identifizieren zu können.
- Nach dem Erstellen des Schlüssels wird dir einmalig ein «Client Secret» angezeigt, welches du sicher aufbewahren sollst.
Haftungsausschluss #
Bitte gehe sorgfältig mit deinen API-Schlüsseln um. Gestohlene API-Schlüssel können grossen Schaden verursachen, da sie unbefugten Personen den Zugriff auf deine Daten und Systeme ermöglichen. Wir übernehmen keine Haftung für verlorene oder missbrauchte API-Schlüssel.
Token erstellen #
Um deinen API-Schlüssel in ein Token umzuwandeln, führe folgendes Python Script aus. Du kannst das Script auch jederzeit (zb. via ChatGpt) in eine beliebige andere Programmiersprache konvertieren.
import requests
response = requests.post(
url="https://auth.digitalmembers.ch/realms/members/protocol/openid-connect/token",
data={
"client_id": "{deine client_id}",
"client_secret": "{dein client_secret}",
"grant_type": "client_credentials",
},
headers={"content-type": "application/x-www-form-urlencoded"},
)
print(response.json())
token = response.json()["access_token"]
API Request #
Das erstellte Access Token kann nun wie folgt verwendet werden.
response = requests.get(f"https://api.digitalmembers.ch/v2/member/", headers={"Authorization": f"Bearer {token}"}).json()
for member in response.get("items"):
print(member)
API Docs #
Alle API’s sind für Organisations-Administratoren unter https://docs.digitalmembers.ch dokumentiert.
Melde dich mit deinen DigitalMembers-Zugangsdaten an, um Zugriff zu erhalten.