CHPP Development/XML/playerDetails

CHPP Documentation - playerDetails.asp

This page offers XML and HTML interfaces to the information abour a specified player. The XML interface enables CHPP developers to integrate these data into their applications.

Important!

Please note that it is strictly forbidden to develop applications that works with this or other XML/hrf files unless you are a CHPP developer. It is also illegal to use other applications than standard browsers or CHPP approved programs to access the data on the site. Violation of these rules might render you to lose your team.

Only the XML version of this file may be included in CHPP applications.

Current version

Current version of the XML output is 1.0

Syntax

playerDetails.asp?
     outputType = {HTML | XML}
     actionType = {view}
     playerID = integer

Indata parameters

outputType

Indicates whether the output to the client should be an HTML document or an XML file. Only the XML document may be used for CHPP use.

actionType

Indicates what type of action the page should perform.

Value	Default	Description
view	Default	View the player details.

Outdata parameters

The XML output can contain the following tags/containers:

HattrickData

Generic tag wrapped around all XML data from Hattrick.

FileName (Within HattrickData)

The name of the file that your request was sent to.

Version (Within HattrickData)

The current version number of the XML output.

UserID (Within HattrickData)

The logged on User's UserID (not to be confused with TeamID). If not logged on, it defaults to 0.

UserIsSupporter (Within HattrickData)

Indicated if the fetching user has a supporter subscription or not. Return 1 if the user has a supporter subscription. 0 otherwise.

UserHasClubhouse (Within HattrickData)

Indicated if the fetching user has a ClubHouse or not. Return 1 if the user has a ClubHouse. 0 otherwise.

FetchedDate (Within HattrickData)

Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

ActionType (Within HattrickData)

The requested ActionType.

ActionResult (Within HattrickData)

Has 1 attribute: "Success" with value 1 if everything went ok, otherwise 0. Content in ActionResult is OK if the request was successful, otherwise a short error message should be returned.

Player (Within HattrickData)

Container for the player.

PlayerID (Within Player)

The globally unique PlayerID.

PlayerName (Within Player)

The Player name.

PlayerNumber (Within Player)

The number (1 to 99) that the owner (if he/she is HT Supporter) of the team has assigned this player. If player have no player number an attribute named Available is set to false and the container is empty, otherwise to true.

Age (Within Player)

The age of the player.

PlayerForm (Within Player)

The current form, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

Cards (Within Player)

The number of currently accumulated cards. If the player is suspended, this will return 3 (whether the player has actually accumulated 3 bookings, or if he has become suspended by being sent off after 2 bookings in the same game). If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

InjuryLevel (Within Player)

The number of weeks the player is predicted to be injured. If the player is bruised, a value of 0 is returned. If the player is healthy, a value of -1 is returned. If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Statement (Within Player)

If the owner is a HT Supporter, he may have provided a Statement from his players. If player have no statement an attribute named Available is set to false and the container is empty, otherwise to true.

PlayerLanguage (Within Player)

The language the player speaks in his Statement, if existing. If player have no statement an attribute named Available is set to false and the container is empty, otherwise to true.

TrainerData (Within Player)

Container for the skills that relate to coach/trainer ability. Only provided if the player has been made into a trainer, "has gained trainer license". It is provided irrespective of if he is actually serving as the appointed coach of the club or not. If player have no trainer skills an attribute named Available is set to false and the container is empty, otherwise to true.

TrainerType (Within TrainerData)

Integer indicating the type of trainer:

Value	Description
0	Defensive
1	Offensive
2	Balanced

TrainerSkill (Within TrainerData)

The trainer skill, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

Agreeability (Within Player)

The agreeability of the player, given as an integer with 1 indicating the lowest level (se Denominations appendix of rules).

Aggressiveness (Within Player)

The aggressiveness of the player, given as an integer with 1 indicating the lowest level (see Denominations appendix of rules).

Honesty (Within Player)

The honesty of the player, given as an integer with 1 indicating the lowest level (see Denominations appendix of rules).

Experience (Within Player)

The experience of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

Leadership (Within Player)

The leadership of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

Specialty (Within Player)

Integer indicating the specialty (if any) of the player:

Value	Description
0	No specialty.
1	Technical.
2	Quick.
3	Powerful.
4	Unpredictable.
5	Head specialist.

NativeLeagueID (Within Player)

LeagueID of the league where the player was born.

NativeLeagueName (Within Player)

LeagueName of the league where the player was born.

TSI (Within Player)

The Total Skill Index (TSI) of the player.

OwningTeam (Within Player)

Container for the team that owns the player. If player have no owner (Bosman Case) an attribute named Available is set to false and the container is empty, otherwise to true.

TeamID (Within OwningTeam)

The globally unique TeamID of the team owning the player.

TeamName (Within OwningTeam)

The full team name of the team owning the player.

LeagueID (Within OwningTeam)

LeagueID for the league of the team owning the player.

Salary (Within Player)

The salary of the player, given in the default currence (Currency rate 1. There are 10 default currency units per US$). The container is empty If the player has no owner.

IsAbroad (Within Player)

The abroad status of the player, given as an integer. 0 for beeing in home country, 1 for beeing in a team abroad. The container is empty If the player has no owner.

PlayerSkills (Within Player)

Container for the skills of a player. If the skills is a secret to the fetching user an attribute named Available is set to false and the container is empty, otherwise to true.

StaminaSkill (Within PlayerSkills)

The stamina skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

KeeperSkill (Within PlayerSkills)

The keeper skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

PlaymakerSkill (Within PlayerSkills)

The playmaker skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

ScorerSkill (Within PlayerSkills)

The scorer skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

PassingSkill (Within PlayerSkills)

The passing skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

WingerSkill (Within PlayerSkills)

The winger skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

DefenderSkill (Within PlayerSkills)

The defender skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

SetPiecesSkill (Within PlayerSkills)

The set pieces skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

Caps (Within Player)

The number of matches played for the national team.

CapsU20 (Within Player)

The number of matches played for the U-20 national team.

CareerGoals (Within Player)

The total number goals throughout this player's carreer. If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true. Please note that some of these data have become somewhat corrupt over the years, something that cannot be fixed.

CareerHattricks (Within Player)

The total number hattricks throughout this player's carreer. If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true. Please note that some of these data have become somewhat corrupt over the years, something that cannot be fixed.

LeagueGoals (Within Player)

The number of goals in the league this season. If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true. Please note that some of these data can sometimes be somewhat corrupt.

CupGoals (Within Player)

The number of goals in the cup this season. If the team the player belongs to is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true. Please note that some of these data can sometimes be somewhat corrupt.

NationalTeamID (Within Player)

If the player is enrolled on a national team, this is that national team's ID.

NationalTeamName (Within Player)

If the player is enrolled on a national team, this is that national team's name.

TransferListed (Within Player)

Returns 1 if the player is on the transfer list, otherwise 0.