This shows you the differences between two versions of the page.
dswpbot:api_onlinepeople [2010/02/25 19:33] SvaRoX |
dswpbot:api_onlinepeople [2014/02/08 15:36] (current) Zottel |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | =====DSWP API: online people===== | + | ======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. | + | Use this API to get a list of people online on the various DSWP-related servers (game servers, mumble server, forum and IRC channel on Quakenet). Only people registered on the forum are listed. |
- | ====How to use==== | + | =====How to use===== |
Get the data on this link :\\ | Get the data on this link :\\ | ||
http://www.dswp.de/old/dswp_tools/svarox/whoswhere_flat.php | http://www.dswp.de/old/dswp_tools/svarox/whoswhere_flat.php | ||
Line 15: | Line 15: | ||
* **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 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. | * **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. | + | * **current name** (string): nickname currently used on a server (game server, mumble, forum or IRC). If the user is connected to various servers, priorities are : game server > mumble > IRC > forum. |
- | * **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. | + | * **bit mask** (integer): bit mask containing the servers where the user is connected to. Use bitwise AND to handle this value. See below for servers bit masks. |
- | ====Servers bit masks==== | + | =====Server bit masks===== |
TDM: 1\\ | TDM: 1\\ | ||
Bomb: 2\\ | Bomb: 2\\ | ||
Jump: 4\\ | Jump: 4\\ | ||
- | TS: 8\\ | + | Team survivor: 8\\ |
Mumble: 16\\ | Mumble: 16\\ | ||
- | IRC: 32 | + | IRC: 32\\ |
+ | Forum: 64\\ | ||
+ | TDM4.2: 128 | ||
+ | |||
+ | =====Notes===== | ||
+ | Game servers and IRC online status are refreshed every 30 seconds, forum and mumble online status are retrieved in real-time, so the best refresh time value is probably 30 seconds (one update ensured for every servers and not much traffic). | ||
- | ====Notes==== | + | <WRAP categories> |
- | 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). | + | | **[[category:categories|Categories]]**: **[[category:dswp-projects-and-coding|DSWP projects & coding]]** | |
+ | </WRAP> |