dswp.de • DSWP API: online people

dswpbot/api_onlinepeople.1267122791.txt.gz · Last modified: 2010/02/25 19:33 by SvaRoX

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

=====DSWP API: online people=====
====Introduction====
Use this API to get a list of people online on the various DSWP-related servers (game servers, mumble server and IRC channel on Quakenet). Only people registered on the forum are listed.
====How to use====
Get the data on this link :\\ 
http://www.dswp.de/old/dswp_tools/svarox/whoswhere_flat.php

Data are stored in CSV format separated by semicolons, for example :\\ 
//226;rastaskud;RastaSkud;1\\ 
760;manhut;manhut;32\\ 
170;SvaRoX;SvaRoX;49//

The format of each line is :\\ 
**forum id**;**forum name**;**current name**;**bit mask**
  * **forum id** (integer): phpbb forum id. You can use this value provide an URL to someone's profile, for example http://dswp.de/old/memberlist.php?mode=viewprofile&u=170.
  * **forum name** (string): dswp.de forum name. Note: the name can be changed so it may be unsafe to store it for identification purpose.
  * **current name** (string): nickname currently used on a server (game server, mumble or IRC). If the user is connected to various servers, priorities are : IRC > mumble > game servers.
  * **bit mask** (integer): bit mask containing the servers where the user is connected to. Use bitwise AND to handle this value. See below for server bit masks.

====Servers bit masks====
TDM: 1\\ 
Bomb: 2\\ 
Jump: 4\\ 
TS: 8\\ 
Mumble: 16\\ 
IRC: 32

====Notes====
Game servers and IRC online status are refreshed every 30 seconds, mumble online status is retrieve in real-time, so the best refresh time value is probably 30 seconds (one update and not much traffic).