Hallo zusammen,
wir haben die
schon bestehenden Zugriffsmöglichkeiten per API stark erweitert, um Entwicklern den automatisierten Zugriff auf unterschiedliche Daten zu erleichtern. Falls sich die Programmierer unter unseren Nutzern weitere Möglichkeiten wünschen prüfen wir gerne die Machbarkeit, bitte einfach melden. Im Folgenden eine Übersicht über die neuen API Methoden.
Methoden die ohne Nutzername und Passwort aufgerufen werden können:
get_replacers:
get_toplist (
optional auch mit Nutzername und Passwort: liefert auch bei deaktivierter Top-Liste Daten):
Code: Alles auswählen
{
"Alex": {
"seconds" : 7,
"totalseconds" : "2377207",
"hours" : "12",
"minutes" : "20",
"days" : "27"
},
"Max": {
"seconds" : 35,
"totalseconds" : "3047315",
"hours" : "6",
"minutes" : "28",
"days" : "35"
}
}
get_teamlist_json:
Code: Alles auswählen
{
"hauptadmin" : "Linus",
"admins" : [
"Dennis", "DG"
],
"mods" : []
}
get_onlinelist_json:
Code: Alles auswählen
{
"sep.tester" : [
{
"profil" : "0",
"awayreason" : "",
"iconid" : "",
"away" : "0",
"rang" : "admin",
"name" : "Tester"
}
],
"main" : [
{
"profil" : "0",
"awayreason" : "",
"iconid" : "",
"away" : "0",
"rang" : "admin",
"name" : "Linus"
}
]
}
Methoden die nur mit Nutzername und Passwort aufgerufen werden können:
get_sid:
Code: Alles auswählen
{
"sid: "aDnkcE2uPRTjOzKvOxa0Kuxdl4yaGwP7moRkONLkkK8H74xODXwK"
}
Methoden die nur mit Nutzername und Passwort eines Admins aufgerufen werden können:
get_userdata:
Code: Alles auswählen
{
"profile" : "true",
"points" : "0",
"loginmessage" : "betritt den Chat",
"lastseen" : "04.07.2020 [19:02]",
"registered" : "04.70.2020 [19:00]",
"username" : "Tester",
"level" : "Chatter",
"alias" : "<b><font color=\"red\">Tester</font></b>",
"messenger" : "",
"ip" : "22.33.44.*",
"status" : "frei",
"logoutmessage" : "verlässt den Chat",
"mail" : "example@example.de",
"logins" : "1",
"hp" : "",
"sex" : "m",
"gbentries" : "0",
"newsletter" : "true"
}
get_announcements:
Code: Alles auswählen
{
"registered": "Hallo %USER%, du bist zum %CHATS%. mal im Chat!",
"team": "Danke für deine Mitarbeit im Team! :-)",
"guest": "Hallo %user%, wenn Du Dich registrierst hast Du tolle Möglichkeiten!"
}
get_allusers, get_kickedusers, get_bannedusers, get_lockedusers, get_mutedusers:
get_channels:
Code: Alles auswählen
{
"active" : "true",
"onloginpage" : "true",
"list" : [
"Hauptchat",
"Testraum"
]
}
get_settings:
Code: Alles auswählen
{
"google" : "true",
"toplist" : "20",
"guestwhisper_receive" : "true",
"loginpage" : "",
"guestwhisper_send" : "true",
"webspace" : "true",
"nobanner" : "1375966813",
"login" : "true",
"replacer" : "true",
"showusernum" : "true",
"showusers" : "true",
"openreg" : "true",
"owncmds" : "true",
"guestaccess" : "true",
"profiles" : "true"
}
get_reglog:
Code: Alles auswählen
[
{
"timestamp" : "1350241078",
"time" : "20:57",
"date" : "14.10.2012",
"deleted" : "true",
"username" : "Alex"
},
{
"timestamp" : "1349370052",
"time" : "19:00",
"date" : "04.10.2012",
"deleted" : "false",
"username" : "Max"
}
]
get_cmdlog:
Code: Alles auswählen
[
{
"timestamp" : "1353322161",
"subject" : "Tester",
"date" : "19.11.2012",
"time" : "11:49",
"action" : "knebel 1",
"username" : "Webkicks"
},
{
"timestamp" : "1353321936",
"subject" : "Tester",
"date" : "19.11.2012",
"time" : "11:55",
"action" : "bann",
"username" : "Webkicks"
}
]
get_invalidpasslog:
Code: Alles auswählen
[
{
"timestamp" : "1353212029",
"time" : "05:13",
"date" : "18.11.2012",
"IP" : "11.22.33.44",
"username" : "Tester"
},
{
"timestamp" : "1353212026",
"time" : "05:13",
"date" : "18.11.2012",
"IP" : "11.22.33.44",
"username" : "Tester"
}
]
get_dellog:
Code: Alles auswählen
[
{
"timestamp" : "1350911442",
"time" : "15:10",
"date" : "22.10.2012",
"by" : "wk_autodel",
"username" : "Alex"
},
{
"timestamp" : "1341666333",
"time" : "15:05",
"date" : "07.07.2012",
"by" : "Tester",
"username" : "Max"
}
]
Die schon bestehende API wurde um die Methoden erweitert, die API ist weiterhin unter http://server
X.webkicks.de/
CHATNAME/api/
METHODE erreichbar. Funktion, die Nutzername und Passwort benötigen, können via http://server
X.webkicks.de/
CHATNAME/api/ADMINNAME/PASSWORT/
METHODE aufgerufen werden. Für zusätzliche Parameter (Chattername bei get_userdata) wird noch ein /
CHATTERNAME an die URL angehängt.
Optional kann die Rückgabe auch als JSONP (JSON mit Padding) erfolgen, wodurch es möglich ist, die Same-Origin-Policy zu umgehen. Der Aufruf sieht hier wie folgt aus:
http://server
X.webkicks.de/
CHATNAME/api/
METHODE?jsonp=
Callback
Alternativ können die Parameter auch per "POST" übergeben werden, dafür bitte folgende Daten nutzen:
API: http://server
X.webkicks.de/
CHATNAME/api
cid: Chatname
user: Adminname
pass: Passwort
job: Methode
message (
optional): Zusätzlicher Parameter (z.B. für get_userdata)
Wir hoffen es finden sich einige schöne Anwendungsfälle für die neuen Funktionen
![Smilie :)](./images/smilies/icon_smile.gif)