dswpbot/api_onlinepeople.1267139531.txt.gz · Last modified: 2010/02/26 00:12 by SvaRoX

DSWP API: online people

This is an old revision of the document!


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 servers bit masks.

Servers bit masks

TDM: 1
Bomb: 2
Jump: 4
Team survivor: 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 ensured for every servers and not much traffic).