in der Vergangenheit kam häufiger der Wunsch auf, die Chat-Datenbank mit eigenen Datenbanken (z.B. dem eigenen Forum) zu verbinden, damit sich Nutzer nicht mehrfach für verschiedene Dienste derselben Website registrieren müssen. Aus diversen technischen Gründen sind Direktzugriffe auf die Chatdatenbank grundsätzlich nicht möglich. Dennoch möchten wir künftig gerne eine gewisse Basis-Funktionalität bereitstellen, mit der sich die Chat-Datenbank an andere Systeme andocken lässt. Hierzu stellen wir zum Start die folgenden API-Methoden zur Verfügung:
chatter_create
Aufruf: https://serverX.webkicks.de/chatname/api/username/password/chatter_create?nickname=NUTZER&password=PASSWORT&email=EMAIL&bady=TT-MM-JJJJ
Die Abschnitte serverX, chatname, username und password müssen durch gültige Admin-Nutzerdaten ersetzt werden. Die Abschnitte NUTZER, PASSWORT, EMAIL und BDAY sind durch die Daten zu ersetzen, für die ein neuer Nutzeraccount im Chat angemeldet werden soll. Falls der Nutzer das 16. Lebensjahr noch nicht vollendet hat muss zusätzlich die E-Mail-Adresse der Eltern mit &parentmail=EMAIL-DER-ELTERN übergeben werden. Die Eltern werden dann zunächst per E-Mail um Zustimmung gebeten, bevor das Nutzerkonto aktiviert wird.
Funktion: Der Aufruf erzeugt einen neuen Nutzeraccount im Chat und sendet eine Freischaltmail an die per EMAIL definierte E-Mailadresse des Nutzers. Dieser Schritt kann aus rechtlichen Gründen leider nicht entfallen und es ist wichtig, dass hier wirklich die E-Mailadresse des neuen Nutzers angegeben wird und keine eigene. Andernfalls könnte der Nutzer die "Passwort vergessen"-Funktion nicht nutzen, würde keine Chat-Newsletter erhalten und im schlimmsten Fall würdet Ihr für rechtliche Verstöße des Nutzers zur Haftung gezogen. Bitte daher immer die korrekte E-Mailadresse des Nutzers übermitteln.
Zielsetzung: Die Funktion kann automatisiert aufgerufen werden, sobald sich ein Nutzer in einem anderen System (z.B. in einem Forum) registriert. Der Nutzer spart sich somit die zusätzliche Registrierung im Chat und erhält direkt die Freischaltmail.
Rechtliches: Der Nutzer muss vorab ausdrücklich darauf hingewiesen werden, dass er automatisch auch im Chat angemeldet wird. Bitte weist ihn entsprechend darauf hin und bietet ggf. auch eine Möglichkeit, die zusätzliche Anmeldung im Chat nicht durchzuführen.
chatter_delete
Aufruf: https://serverX.webkicks.de/chatname/api/username/password/chatter_delete?nickname=NUTZER
Die Abschnitte serverX, chatname, username und password müssen durch gültige Admin-Nutzerdaten ersetzt werden. NUTZER ist durch den Nutzernamen im Chat zu ersetzen, der gelöscht werden soll.
Funktion: Löscht den Nutzeraccount von NUTZER vollständig aus der Chat-Datenbank.
Zielsetzung: Hierüber kann erreicht werden, dass ein Nutzer automatisch auch aus der Chat-Datenbank gelöscht wird, wenn er die Löschung an anderer Stelle (z.B. in Eurem Forum) vornimmt. Ihr vermeidet auf diesem Weg, dass sich ein Nutzer zwar von Eurer Website löscht, der Account im Chat aber versehentlich bestehen bleibt. Auch hier sollte der Nutzer explizit darauf hingewiesen werden, dass eine Löschung im Chat erfolgt.
Der Aufruf der API-Funktionen wird im Erfolgsfall wie folgt bestätigt:
Code: Alles auswählen
{
"message" : "ok",
"statuscode" : 1
}
Code: Alles auswählen
{
"message" : "invalid nickname",
"statuscode" : 201
}
Hier eine Übersicht über alle Fehlercodes:
- chatter_create
- 101 Der Nutzername ist schon vergeben
- 102 Der Nutzername wird derzeit von einem Gast genutzt
- 103 Der Nutzername ist durch die Nicksperre gesperrt
- 104 Der Nutzername hat mehr als 20 Zeichen
- 105 Der Nutzername hat weniger als 2 Zeichen
- 106 Der Nutzername ist systemseitig verboten (z.B. "Webkicks")
- 107 Der Nutzername enthält verbotene Zeichen
- 108 Das Passwort hat mehr als 30 Zeichen
- 109 Das Passwort hat weniger als 6 Zeichen
- 110 Das Passwort enthält verbotene Zeichen
- 111 Die E-Mailadresse hat mehr als 100 Zeichen
- 112 Die E-Mailadresse ist ungültig
- 113 Es existiert bereits ein Nutzeraccount mit dieser E-Mailadresse
- 114 Die E-Mailadresse ist gesperrt
- 115 Das Geburtsdatum ist ungültig
- 116 Die E-Mailadresse der Eltern hat mehr als 100 Zeichen
- 117 Die E-Mailadresse der Eltern ist ungültig
- chatter_delete
- 201 Es wurde kein NICKNAME übergeben
- 202 NICKNAME ist Mod oder Admin
Viele Grüße
WK-Team