API Developer Guide :: Getting a profile of the specified member

igGameCenter API Developer Guide >> Getting a profile of the specified member
For getting an information about a profile of specific member an external application should send a POST request to the following API script:
http://www.iggamecenter.com/api_profile.php
containing the following parameters:
Field Name Field Content Field Format
app_id Application unique ID mandatory, numeric
app_code Application secret passcode mandatory, alpha-numeric
uid An ID of the member whose profile is requested mandatory, numeric
session_id Unique session ID that was received during authorization procedure) optional, alpha-numeric
stat Non-zero value specifies that a game statistics should be included in the response. optional, numeric
log Non-zero value specifies that a log of 20 last games should be included in the response. optional, numeric
The returned response will be one of the following:
Failure response:

<errorMessage>--Some error message--</errorMessage>

Success response:

<profile>
<curtime>1186039205</curtime>
<isFastReg>0</isFastReg>
<name>Arty</name>
<realName>Arty Sandler</realName>
<sex>M</sex>
<birthDate>9-1-1978</birthDate>
<country></country>
<location></location>
<about></about>
<registrationTime>1179852473</registrationTime>
<lastAliveTime>1186032756</lastAliveTime>
<idleTimeSec>14</idleTimeSec>

<gameStat>
    <game gid="1" score="272" numGames="76" numWin="54" numLoss="17" numDraw="5" numQuit="0" />
    <game gid="2" score="0" numGames="2" numWin="1" numLoss="1" numDraw="0" numQuit="1" />
    <game gid="3" score="57" numGames="4" numWin="3" numLoss="0" numDraw="1" numQuit="0" />
    <game gid="4" score="148" numGames="16" numWin="13" numLoss="0" numDraw="3" numQuit="0" />
    <game gid="5" score="127" numGames="9" numWin="9" numLoss="0" numDraw="0" numQuit="0" />
    <game gid="6" score="296" numGames="40" numWin="35" numLoss="4" numDraw="1" numQuit="1" />
    <game gid="7" score="79" numGames="16" numWin="10" numLoss="5" numDraw="1" numQuit="0" />
    <game gid="8" score="114" numGames="15" numWin="11" numLoss="4" numDraw="0" numQuit="0" />
    <game gid="9" score="91" numGames="21" numWin="12" numLoss="7" numDraw="2" numQuit="0" />
    <game gid="10" score="128" numGames="18" numWin="13" numLoss="5" numDraw="0" numQuit="0" />
    <game gid="11" score="7" numGames="14" numWin="8" numLoss="6" numDraw="0" numQuit="0" />
</gameStat>

<gameLog>
    <game gid="1" createTime="1185957581" durationMin="181">
        <players>
            <player uid="481" name="menaceman" stat="LOST" scoreOld="1500"
scoreNew="1490" />
            <player uid="2" name="Arty" stat="WIN" scoreOld="1507"
scoreNew="1507" />
        </players>
    </game>
    <game gid="8" createTime="1185908180" durationMin="24">
        <players>
            <player uid="487" name="lizinks" stat="LOST" scoreOld="1600"
scoreNew="1590" />
            <player uid="2" name="Arty" stat="WIN" scoreOld="1550"
scoreNew="1560" />
        </players>
    </game>
</gameLog>
</profile>

where

Field Name Field Content
curtime Unix timestamp of the current time on the server. Using this timestamp you can calculate a difference between local and server time and then use this difference for converting all the timestamps included in this profile to the local time.
profile The main container including the profile information
isFastReg 0 - the member passed a certified registration process.

1 - the member passed a fast registration process.
email Member's email address.
This field is included in the response only if the member allowed showing his email or if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
name Member's nickname
realName Member's real name
sex Member's sex (could be M,F or -)
birthDay Day of member's birth.
This field is included in the response only if the member allowed showing his birthdate or if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
birthMonth Month of member's birth.
This field is included in the response only if the member allowed showing his birthdate or if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
birthYear Year of member's birth.
This field is included in the response only if the member allowed showing his birthdate or if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
country 2-letters country code.
location More detailed location of the member
about Some information entered by the member describing himself. (new lines are encoded as \n)
registrationTime Unix timestamp when this member registered an account
lastAliveTime Unix timestamp when this member was last seen by the igGameCenter server
idleTimeSec Number of seconds this member is idle (i.e. haven't perform any action)
subscribeNews Any non-zero value means that the member is willing to subscribe to igGameCenter's newsletter.
This field is included in the response only if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
showEmail

Any non-zero value means that the member is willing to show his email on his public profile.
This field is included in the response only if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.

showBirthday Any non-zero value means that the member is willing to show his birthday on his public profile.
This field is included in the response only if the parameter session_id was sent in the POST request along with uid and they both match the currently authorized user.
gameStat A container for an information about the game statistics.
This container is included in the response only if the parameter stat was sent in the POST request containing non-zero value.
game A container for an information about a single game.
gid ID of the game.
score Member's score achieved in this game.
numGames Number of games played by this member
numWin Number of games won by this member
numLoss Number of games lost by this member
numLoss Number of games played by this member, which were ended up by a draw
numQuit Number of active games this member quit
gameLog A container for an information about last 20 games played by the member.
This container is included in the response only if the parameter log was sent in the POST request containing non-zero value.
game A container for an information about a single game.
gid ID of the game.
createTime Unix timestamp of the game start time.
durationMin Duration of the game in minutes.
players A container for an information about players participated in this game.
player A container for an information about a single player.
uid Member's ID of the player.
name Player's name.
stat A state of the player.

DRAW - the game was finished with a draw (the state of both players is DRAW)
WIN - the player won the game
LOST - the player lost the game
QUIT - the player quit the active game and his opponent claimed player's loss
scoreOld The old score (before the game) of the player.
scoreNew The new score (after the game) of the player.

[create new page] [copy this page] [edit this page] [translate this page] [view history]

© 2015. Created by Arty Sandler. Privacy Policy