Hattrick - User contributions [en]

CHPP Development/XML/teamDetails

2006-10-16T07:02:31Z

Neohugin:

This page offers XML and HTML interfaces to see the basic data for a '''team'''. The XML interface enables CHPP developers to integrate these data into their applications.

Note: It appears that the custom dress kit resets the CHPP settings for Dress and DressAlternate.

{{CHPP Documentation}}

== Current version ==
This documentation applies to version 1.7 of the XML output.

== Syntax ==
teamDetails.asp?
outputType = {HTML | XML}
actionType = {view}
[{teamID = integer |
userID = 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the basic team data.
|}

=== teamID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted.

=== userID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted. If neither userID or teamID is supplied, userID defaults to the logged on user's userID.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== User (Within HattrickData) ===
Container for the data about the user ("owner").

=== UserID (Within User) ===
The globally unique UserID for the owner of the team. Teams without an owner have UserID = 0.

=== Language (Within User) ===
Container for the data about the language the user has chosen as his/her default language.

=== LanguageID (Within Language) ===
The globally unique LanguageID.

=== LanguageName (Within Language) ===
The Language name.

=== HasSupporter (Within User) ===
Boolean value indicating whether the user is currently a Hattrick Supporter. Not supplied if the team is ownerless.

=== Loginname (Within User) ===
The "username" or "nickname" used in conferences and for login. Not supplied if the team is ownerless.

=== Name (Within User) ===
The user's personal name or the value HIDDEN to indicate that the user has chosen to hide it. Not supplied if the team is ownerless.

=== ICQ (Within User) ===
The user's ICQ number (if any). Not supplied if the team is ownerless.

=== SignupDate (Within User) ===
The date and time when the user signed up for Hattrick. Not supplied if the team is ownerless.

=== ActivationDate (Within User) ===
The date and time when the user gained control of this team. Not supplied if the team is ownerless.

=== LastLoginDate (Within User) ===
The date and time when the user last logged on. Not supplied if the team is ownerless.

=== NationalTeamCoach (Within User) ===
Container for the national teams. An attribute named ''Count'' specifies how many national teams this user coaches. If 0, the child node does not exist.

=== NationalTeam (Within NationalTeamCoach) ===
Container for a National Team. An attribute called ''Index'' signifies the number of the national team in the list (not to be confused with NationalTeamID which is globally unique). Index ranges from 0 to (Count - 1).

=== NationalTeamID (Within NationalTeam) ===
The globally unique identifier of the national team.

=== NationalTeamName (Within NationalTeam) ===
The name of the national team

=== Team (Within HattrickData) ===
Container for the data about the team (not supplied for user without team).

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== ShortTeamName (Within Team) ===
The short team name.

=== Arena (Within Team) ===
Container for the data about the team's home ground.

=== ArenaID (Within Arena) ===
The globally unique ArenaID.

=== ArenaName (Within Arena) ===
The arena name.

=== League (Within Team) ===
Container for the data about the league ("Sverige", "England" and so on) the team is part of.

=== LeagueID (Within League) ===
The globally unique LeagueID.

=== LeagueName (Within League) ===
The League name.

=== Region (Within Team) ===
Container for the data about the region theteam is located in.

=== RegionID (Within Region) ===
The globally unique RegionID.

=== RegionName (Within Region) ===
The Region name.

=== Trainer (Within Team) ===
The player that is trainer ("coach") for the team. (Not to be confused with the "owner"/"user").

=== PlayerID (Within Trainer) ===
The globally unique PlayerID of the player that has the job as trainer of the team.

=== PlayerName (Within Trainer) ===
The name of the trainer.

=== HomePage (Within Team) ===
The home page URL that the team has specified.

=== Clubhouse (Within Team) ===
Exists only if the team has a Clubhouse and if so holds the name of that clubhouse. The URL of the clubhouse will then be http://club.hattrick.org/ClubhouseName/ where ClubhouseName is a placeholder for the value in tag Clubhouse.

=== Cup (Within Team) ===
Data about the team's cup status. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== StillInCup (Within Cup) ===
Boolean value stating if the team is still in the cup.

=== CupID (Within Cup) ===
The globally unique CupID of the cup that the team is still in. Only provided if team is still in cup.

=== CupName (Within Cup) ===
The name of the cup that the team is still in. Only provided if team is still in cup.

=== FriendlyBooked (Within Team) ===
'''This element is obsolete and will probably be removed within 1-2 months.'''

The team's status about if friendly is booked. The value is true if team has booked a friendly, false if not. If the team is playing a match, an attribute named ''Available'' is set to false and the container is empty, otherwise to true.

=== FriendlyTeamID (Within Team) ===
The team's status about if a friendly is booked. The value is the opponents globally unique teamID if the team has booked a friendly, 0 if not. If the team is playing a match, an attribute named ''Available'' is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnit (Within Team) ===
Data about the team's LeagueLevelUnit ("series"). If the team is playing a qualification match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnitID (Within LeagueLevelUnit) ===
The globally unique LeagueLevelUnitID.

=== LeagueLevelUnitName (Within LeagueLevelUnit) ===
The name of the LeagueLevelUnit.

=== LeagueLevel (Within LeagueLevelUnit) ===
Integer value stating the relative level of the LeagueLevelUnit, with 1 indicating the league's top series.

=== NumberOfVictories (Within Team) ===
If the team is in a winning streak of at least 2 matches, this integer indicates how many victories in a row it currently has. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== NumberOfUndefeated (Within Team) ===
If the team is in a streak of at least 2 matches as undefeated, this integer indicates how many matches in a row it is undefeated. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LogoURL (Within Trainer) ===
The logo URL that the team has specified. Only supplied if the user has Hattrick Supporter

=== Fanclub (Within Team) ===
Container for the data about the team's fanclub. Only supplied if the user has Hattrick Supporter.

=== FanclubID (Within Fanclub) ===
The globally unique FanclubID. Only supplied if the user has Hattrick Supporter.

=== FanclubName (Within Fanclub) ===
The name of the fanclub. Only supplied if the user has Hattrick Supporter.

=== Guestbook (Within Team) ===
Container for the data about the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== NumberOfGuestbookItems (Within Guestbook) ===
The number of postings in the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== PressAnnouncement (Within Team) ===
Container for the data about the user's most recent PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Subject (Within PressAnnouncement) ===
The subject text specified for the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Body (Within PressAnnouncement) ===
The body of the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== SendDate (Within PressAnnouncement) ===
The time and date when the PressAnnouncement was submitted. Only supplied if the user has Hattrick Supporter.

=== Dress (Within Team) ===
7 character string representing the dress of the team: First characters is a letter indicating type pf dress. Next two numbers indicate the shirt colour, next two indicate pants colour and final two numbers indicate socks colour.

=== DressAlternate (Within Team) ===
Same as dress, except that it shows the alternate dress.

=== BotStatus (Within Team) ===
Container for the data indicating if a team is a "bot", that is, has a default and random lineup and players.

=== IsBot (Within BotStatus) ===
Boolean. Specifies whether a team is currently a bot or not.

=== BotSince (Within BotStatus) ===
The date when the team was made a bot, or 1997-08-30 if the team was made a bot before 2005-12-08. If the team is not a bot, this will return 1900-01-01.

=== TeamRank (Within Team) ===
If the team has an owner, this is the League Rank, a number based on LeagueLevel, postion etc, only counting teams with an owner. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Note: Date format is always YYYY-MM-DD HH:MM:SS.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
teamDetails.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
teamDetails.asp?outputType=XML&actionType=view

CHPP Development/XML/teamDetails

2006-10-16T04:35:07Z

Neohugin:

This page offers XML and HTML interfaces to see the basic data for a team. The XML interface enables CHPP developers to integrate these data into their applications.

Note: It appears that the custom dress kit resets the chpp settings for Dress and DressAlternate.

{{CHPP Documentation}}

== Current version ==
This documentation applies to version 1.7 of the XML output.

== Syntax ==
teamDetails.asp?
outputType = {HTML | XML}
actionType = {view}
[{teamID = integer |
userID = 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the basic team data.
|}

=== teamID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted.

=== userID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted. If neither userID or teamID is supplied, userID defaults to the logged on user's userID.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== User (Within HattrickData) ===
Container for the data about the user ("owner").

=== UserID (Within User) ===
The globally unique UserID for the owner of the team. Teams without an owner have UserID = 0.

=== Language (Within User) ===
Container for the data about the language the user has chosen as his/her default language.

=== LanguageID (Within Language) ===
The globally unique LanguageID.

=== LanguageName (Within Language) ===
The Language name.

=== HasSupporter (Within User) ===
Boolean value indicating whether the user is currently a Hattrick Supporter. Not supplied if the team is ownerless.

=== Loginname (Within User) ===
The "username" or "nickname" used in conferences and for login. Not supplied if the team is ownerless.

=== Name (Within User) ===
The user's personal name or the value HIDDEN to indicate that the user has chosen to hide it. Not supplied if the team is ownerless.

=== ICQ (Within User) ===
The user's ICQ number (if any). Not supplied if the team is ownerless.

=== SignupDate (Within User) ===
The date and time when the user signed up for Hattrick. Not supplied if the team is ownerless.

=== ActivationDate (Within User) ===
The date and time when the user gained control of this team. Not supplied if the team is ownerless.

=== LastLoginDate (Within User) ===
The date and time when the user last logged on. Not supplied if the team is ownerless.

=== NationalTeamCoach (Within User) ===
Container for the national teams. An attribute named ''Count'' specifies how many national teams this user coaches. If 0, the child node does not exist.

=== NationalTeam (Within NationalTeamCoach) ===
Container for a National Team. An attribute called ''Index'' signifies the number of the national team in the list (not to be confused with NationalTeamID which is globally unique). Index ranges from 0 to (Count - 1).

=== NationalTeamID (Within NationalTeam) ===
The globally unique identifier of the national team.

=== NationalTeamName (Within NationalTeam) ===
The name of the national team

=== Team (Within HattrickData) ===
Container for the data about the team (not supplied for user without team).

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== ShortTeamName (Within Team) ===
The short team name.

=== Arena (Within Team) ===
Container for the data about the team's home ground.

=== ArenaID (Within Arena) ===
The globally unique ArenaID.

=== ArenaName (Within Arena) ===
The arena name.

=== League (Within Team) ===
Container for the data about the league ("Sverige", "England" and so on) the team is part of.

=== LeagueID (Within League) ===
The globally unique LeagueID.

=== LeagueName (Within League) ===
The League name.

=== Region (Within Team) ===
Container for the data about the region theteam is located in.

=== RegionID (Within Region) ===
The globally unique RegionID.

=== RegionName (Within Region) ===
The Region name.

=== Trainer (Within Team) ===
The player that is trainer ("coach") for the team. (Not to be confused with the "owner"/"user").

=== PlayerID (Within Trainer) ===
The globally unique PlayerID of the player that has the job as trainer of the team.

=== PlayerName (Within Trainer) ===
The name of the trainer.

=== HomePage (Within Team) ===
The home page URL that the team has specified.

=== Clubhouse (Within Team) ===
Exists only if the team has a Clubhouse and if so holds the name of that clubhouse. The URL of the clubhouse will then be http://club.hattrick.org/ClubhouseName/ where ClubhouseName is a placeholder for the value in tag Clubhouse.

=== Cup (Within Team) ===
Data about the team's cup status. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== StillInCup (Within Cup) ===
Boolean value stating if the team is still in the cup.

=== CupID (Within Cup) ===
The globally unique CupID of the cup that the team is still in. Only provided if team is still in cup.

=== CupName (Within Cup) ===
The name of the cup that the team is still in. Only provided if team is still in cup.

=== FriendlyBooked (Within Team) ===
'''This element is obsolete and will probably be removed within 1-2 months.'''

The team's status about if friendly is booked. The value is true if team has booked a friendly, false if not. If the team is playing a match, an attribute named ''Available'' is set to false and the container is empty, otherwise to true.

=== FriendlyTeamID (Within Team) ===
The team's status about if a friendly is booked. The value is the opponents globally unique teamID if the team has booked a friendly, 0 if not. If the team is playing a match, an attribute named ''Available'' is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnit (Within Team) ===
Data about the team's LeagueLevelUnit ("series"). If the team is playing a qualification match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnitID (Within LeagueLevelUnit) ===
The globally unique LeagueLevelUnitID.

=== LeagueLevelUnitName (Within LeagueLevelUnit) ===
The name of the LeagueLevelUnit.

=== LeagueLevel (Within LeagueLevelUnit) ===
Integer value stating the relative level of the LeagueLevelUnit, with 1 indicating the league's top series.

=== NumberOfVictories (Within Team) ===
If the team is in a winning streak of at least 2 matches, this integer indicates how many victories in a row it currently has. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== NumberOfUndefeated (Within Team) ===
If the team is in a streak of at least 2 matches as undefeated, this integer indicates how many matches in a row it is undefeated. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LogoURL (Within Trainer) ===
The logo URL that the team has specified. Only supplied if the user has Hattrick Supporter

=== Fanclub (Within Team) ===
Container for the data about the team's fanclub. Only supplied if the user has Hattrick Supporter.

=== FanclubID (Within Fanclub) ===
The globally unique FanclubID. Only supplied if the user has Hattrick Supporter.

=== FanclubName (Within Fanclub) ===
The name of the fanclub. Only supplied if the user has Hattrick Supporter.

=== Guestbook (Within Team) ===
Container for the data about the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== NumberOfGuestbookItems (Within Guestbook) ===
The number of postings in the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== PressAnnouncement (Within Team) ===
Container for the data about the user's most recent PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Subject (Within PressAnnouncement) ===
The subject text specified for the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Body (Within PressAnnouncement) ===
The body of the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== SendDate (Within PressAnnouncement) ===
The time and date when the PressAnnouncement was submitted. Only supplied if the user has Hattrick Supporter.

=== Dress (Within Team) ===
7 character string representing the dress of the team: First characters is a letter indicating type pf dress. Next two numbers indicate the shirt colour, next two indicate pants colour and final two numbers indicate socks colour.

=== DressAlternate (Within Team) ===
Same as dress, except that it shows the alternate dress.

=== BotStatus (Within Team) ===
Container for the data indicating if a team is a "bot", that is, has a default and random lineup and players.

=== IsBot (Within BotStatus) ===
Boolean. Specifies whether a team is currently a bot or not.

=== BotSince (Within BotStatus) ===
The date when the team was made a bot, or 1997-08-30 if the team was made a bot before 2005-12-08. If the team is not a bot, this will return 1900-01-01.

=== TeamRank (Within Team) ===
If the team has an owner, this is the League Rank, a number based on LeagueLevel, postion etc, only counting teams with an owner. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Note: Date format is always YYYY-MM-DD HH:MM:SS.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
teamDetails.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
teamDetails.asp?outputType=XML&actionType=view

CHPP Development/XML/players

2006-10-16T03:22:06Z

Neohugin:

This page offers XML and HTML interfaces to see the basic data for a team. The XML interface enables CHPP developers to integrate these data into their applications.

Note: It appears that the custom dress kit resets the chpp settings for Dress and DressAlternate.

{{CHPP Documentation}}

== Current version ==
This documentation applies to version 1.7 of the XML output.

== Syntax ==
teamDetails.asp?
outputType = {HTML | XML}
actionType = {view}
[{teamID = integer |
userID = 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the basic team data.
|}

=== teamID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted.

=== userID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted. If neither userID or teamID is supplied, userID defaults to the logged on user's userID.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== User (Within HattrickData) ===
Container for the data about the user ("owner").

=== UserID (Within User) ===
The globally unique UserID for the owner of the team. Teams without an owner have UserID = 0.

=== Language (Within User) ===
Container for the data about the language the user has chosen as his/her default language.

=== LanguageID (Within Language) ===
The globally unique LanguageID.

=== LanguageName (Within Language) ===
The Language name.

=== HasSupporter (Within User) ===
Boolean value indicating whether the user is currently a Hattrick Supporter. Not supplied if the team is ownerless.

=== Loginname (Within User) ===
The "username" or "nickname" used in conferences and for login. Not supplied if the team is ownerless.

=== Name (Within User) ===
The user's personal name or the value HIDDEN to indicate that the user has chosen to hide it. Not supplied if the team is ownerless.

=== ICQ (Within User) ===
The user's ICQ number (if any). Not supplied if the team is ownerless.

=== SignupDate (Within User) ===
The date and time when the user signed up for Hattrick. Not supplied if the team is ownerless.

=== ActivationDate (Within User) ===
The date and time when the user gained control of this team. Not supplied if the team is ownerless.

=== LastLoginDate (Within User) ===
The date and time when the user last logged on. Not supplied if the team is ownerless.

=== NationalTeamCoach (Within User) ===
Container for the national teams. An attribute named Count specifies how many national teams this user coaches. If 0, the child node does not exist.

=== NationalTeam (Within NationalTeamCoach) ===
Container for a National Team. An attribute called Index signifies the number of the national team in the list (not to be confused with NationalTeamID which is globally unique). Index ranges from 0 to (Count - 1).

=== NationalTeamID (Within NationalTeam) ===
The globally unique identifier of the national team.

=== NationalTeamName (Within NationalTeam) ===
The name of the national team

=== Team (Within HattrickData) ===
Container for the data about the team (not supplied for user without team).

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== ShortTeamName (Within Team) ===
The short team name.

=== Arena (Within Team) ===
Container for the data about the team's home ground.

=== ArenaID (Within Arena) ===
The globally unique ArenaID.

=== ArenaName (Within Arena) ===
The arena name.

=== League (Within Team) ===
Container for the data about the league ("Sverige", "England" and so on) the team is part of.

=== LeagueID (Within League) ===
The globally unique LeagueID.

=== LeagueName (Within League) ===
The League name.

=== Region (Within Team) ===
Container for the data about the region theteam is located in.

=== RegionID (Within Region) ===
The globally unique RegionID.

=== RegionName (Within Region) ===
The Region name.

=== Trainer (Within Team) ===
The player that is trainer ("coach") for the team. (Not to be confused with the "owner"/"user").

=== PlayerID (Within Trainer) ===
The globally unique PlayerID of the player that has the job as trainer of the team.

=== PlayerName (Within Trainer) ===
The name of the trainer.

=== HomePage (Within Team) ===
The home page URL that the team has specified.

=== Clubhouse (Within Team) ===
Exists only if the team has a Clubhouse and if so holds the name of that clubhouse. The URL of the clubhouse will then be http://club.hattrick.org/ClubhouseName/ where ClubhouseName is a placeholder for the value in tag Clubhouse.

=== Cup (Within Team) ===
Data about the team's cup status. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== StillInCup (Within Cup) ===
Boolean value stating if the team is still in the cup.

=== CupID (Within Cup) ===
The globally unique CupID of the cup that the team is still in. Only provided if team is still in cup.

=== CupName (Within Cup) ===
The name of the cup that the team is still in. Only provided if team is still in cup.

=== FriendlyBooked (Within Team) ===
This element is obsolete and will probably be removed within 1-2 months.
The team's status about if friendly is booked. The value is true if team has booked a friendly, false if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== FriendlyTeamID (Within Team) ===
The team's status about if a friendly is booked. The value is the opponents globally unique teamID if the team has booked a friendly, 0 if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnit (Within Team) ===
Data about the team's LeagueLevelUnit ("series"). If the team is playing a qualification match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LeagueLevelUnitID (Within LeagueLevelUnit) ===
The globally unique LeagueLevelUnitID.

=== LeagueLevelUnitName (Within LeagueLevelUnit) ===
The name of the LeagueLevelUnit.

=== LeagueLevel (Within LeagueLevelUnit) ===
Integer value stating the relative level of the LeagueLevelUnit, with 1 indicating the league's top series.

=== NumberOfVictories (Within Team) ===
If the team is in a winning streak of at least 2 matches, this integer indicates how many victories in a row it currently has. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== NumberOfUndefeated (Within Team) ===
If the team is in a streak of at least 2 matches as undefeated, this integer indicates how many matches in a row it is undefeated. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

=== LogoURL (Within Trainer) ===
The logo URL that the team has specified. Only supplied if the user has Hattrick Supporter

=== Fanclub (Within Team) ===
Container for the data about the team's fanclub. Only supplied if the user has Hattrick Supporter.

=== FanclubID (Within Fanclub) ===
The globally unique FanclubID. Only supplied if the user has Hattrick Supporter.

=== FanclubName (Within Fanclub) ===
The name of the fanclub. Only supplied if the user has Hattrick Supporter.

=== Guestbook (Within Team) ===
Container for the data about the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== NumberOfGuestbookItems (Within Guestbook) ===
The number of postings in the user's guestbook. Only supplied if the user has Hattrick Supporter.

=== PressAnnouncement (Within Team) ===
Container for the data about the user's most recent PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Subject (Within PressAnnouncement) ===
The subject text specified for the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== Body (Within PressAnnouncement) ===
The body of the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

=== SendDate (Within PressAnnouncement) ===
The time and date when the PressAnnouncement was submitted. Only supplied if the user has Hattrick Supporter.

=== Dress (Within Team) ===
7 character string representing the dress of the team: First characters is a letter indicating type pf dress. Next two numbers indicate the shirt colour, next two indicate pants colour and final two numbers indicate socks colour.

=== DressAlternate (Within Team) ===
Same as dress, except that it shows the alternate dress.

=== BotStatus (Within Team) ===
Container for the data indicating if a team is a "bot", that is, has a default and random lineup and players.

=== IsBot (Within BotStatus) ===
Boolean. Specifies whether a team is currently a bot or not.

=== BotSince (Within BotStatus) ===
The date when the team was made a bot, or 1997-08-30 if the team was made a bot before 2005-12-08. If the team is not a bot, this will return 1900-01-01.

=== TeamRank (Within Team) ===
If the team has an owner, this is the League Rank, a number based on LeagueLevel, postion etc, only counting teams with an owner. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Note: Date format is always YYYY-MM-DD HH:MM:SS.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
teamDetails.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
teamDetails.asp?outputType=XML&actionType=view

CHPP Development/XML/teamDetails

2006-10-16T03:02:43Z

Neohugin:

This page offers XML and HTML interfaces to see the basic data for a team. The XML interface enables CHPP developers to integrate these data into their applications.

Note: It appears that the custom dress kit resets the chpp settings for Dress and DressAlternate.

{{CHPP Documentation}}

== Current version ==
This documentation applies to version 1.7 of the XML output.

== Syntax ==
teamDetails.asp?
outputType = {HTML | XML}
actionType = {view}
[{teamID = integer |
userID = 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 basic team data.

=== teamID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted.

=== userID ===
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted. If neither userID or teamID is supplied, userID defaults to the logged on user's userID.

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.

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

Version
The current version number of the XML output.

FetchedDate (Within HattrickData)
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

User (Within HattrickData)
Container for the data about the user ("owner").

UserID (Within User)
The globally unique UserID for the owner of the team. Teams without an owner have UserID = 0.

Language (Within User)
Container for the data about the language the user has chosen as his/her default language.

LanguageID (Within Language)
The globally unique LanguageID.

LanguageName (Within Language)
The Language name.

HasSupporter (Within User)
Boolean value indicating whether the user is currently a Hattrick Supporter. Not supplied if the team is ownerless.

Loginname (Within User)
The "username" or "nickname" used in conferences and for login. Not supplied if the team is ownerless.

Name (Within User)
The user's personal name or the value HIDDEN to indicate that the user has chosen to hide it. Not supplied if the team is ownerless.

ICQ (Within User)
The user's ICQ number (if any). Not supplied if the team is ownerless.

SignupDate (Within User)
The date and time when the user signed up for Hattrick. Not supplied if the team is ownerless.

ActivationDate (Within User)
The date and time when the user gained control of this team. Not supplied if the team is ownerless.

LastLoginDate (Within User)
The date and time when the user last logged on. Not supplied if the team is ownerless.

NationalTeamCoach (Within User)
Container for the national teams. An attribute named Count specifies how many national teams this user coaches. If 0, the child node does not exist.

NationalTeam (Within NationalTeamCoach)
Container for a National Team. An attribute called Index signifies the number of the national team in the list (not to be confused with NationalTeamID which is globally unique). Index ranges from 0 to (Count - 1).

NationalTeamID (Within NationalTeam)
The globally unique identifier of the national team.

NationalTeamName (Within NationalTeam)
The name of the national team

Team (Within HattrickData)
Container for the data about the team (not supplied for user without team).

TeamID (Within Team)
The globally unique TeamID.

TeamName (Within Team)
The full team name.

ShortTeamName (Within Team)
The short team name.

Arena (Within Team)
Container for the data about the team's home ground.

ArenaID (Within Arena)
The globally unique ArenaID.

ArenaName (Within Arena)
The arena name.

League (Within Team)
Container for the data about the league ("Sverige", "England" and so on) the team is part of.

LeagueID (Within League)
The globally unique LeagueID.

LeagueName (Within League)
The League name.

Region (Within Team)
Container for the data about the region theteam is located in.

RegionID (Within Region)
The globally unique RegionID.

RegionName (Within Region)
The Region name.

Trainer (Within Team)
The player that is trainer ("coach") for the team. (Not to be confused with the "owner"/"user").

PlayerID (Within Trainer)
The globally unique PlayerID of the player that has the job as trainer of the team.

PlayerName (Within Trainer)
The name of the trainer.

HomePage (Within Team)
The home page URL that the team has specified.

Clubhouse (Within Team)
Exists only if the team has a Clubhouse and if so holds the name of that clubhouse. The URL of the clubhouse will then be http://club.hattrick.org/ClubhouseName/ where ClubhouseName is a placeholder for the value in tag Clubhouse.

Cup (Within Team)
Data about the team's cup status. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

StillInCup (Within Cup)
Boolean value stating if the team is still in the cup.

CupID (Within Cup)
The globally unique CupID of the cup that the team is still in. Only provided if team is still in cup.

CupName (Within Cup)
The name of the cup that the team is still in. Only provided if team is still in cup.

FriendlyBooked (Within Team)
This element is obsolete and will probably be removed within 1-2 months.
The team's status about if friendly is booked. The value is true if team has booked a friendly, false if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

FriendlyTeamID (Within Team)
The team's status about if a friendly is booked. The value is the opponents globally unique teamID if the team has booked a friendly, 0 if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

LeagueLevelUnit (Within Team)
Data about the team's LeagueLevelUnit ("series"). If the team is playing a qualification match, an attribute named Available is set to false and the container is empty, otherwise to true.

LeagueLevelUnitID (Within LeagueLevelUnit)
The globally unique LeagueLevelUnitID.

LeagueLevelUnitName (Within LeagueLevelUnit)
The name of the LeagueLevelUnit.

LeagueLevel (Within LeagueLevelUnit)
Integer value stating the relative level of the LeagueLevelUnit, with 1 indicating the league's top series.

NumberOfVictories (Within Team)
If the team is in a winning streak of at least 2 matches, this integer indicates how many victories in a row it currently has. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

NumberOfUndefeated (Within Team)
If the team is in a streak of at least 2 matches as undefeated, this integer indicates how many matches in a row it is undefeated. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

LogoURL (Within Trainer)
The logo URL that the team has specified. Only supplied if the user has Hattrick Supporter

Fanclub (Within Team)
Container for the data about the team's fanclub. Only supplied if the user has Hattrick Supporter.

FanclubID (Within Fanclub)
The globally unique FanclubID. Only supplied if the user has Hattrick Supporter.

FanclubName (Within Fanclub)
The name of the fanclub. Only supplied if the user has Hattrick Supporter.

Guestbook (Within Team)
Container for the data about the user's guestbook. Only supplied if the user has Hattrick Supporter.

NumberOfGuestbookItems (Within Guestbook)
The number of postings in the user's guestbook. Only supplied if the user has Hattrick Supporter.

PressAnnouncement (Within Team)
Container for the data about the user's most recent PressAnnouncement. Only supplied if the user has Hattrick Supporter.

Subject (Within PressAnnouncement)
The subject text specified for the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

Body (Within PressAnnouncement)
The body of the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

SendDate (Within PressAnnouncement)
The time and date when the PressAnnouncement was submitted. Only supplied if the user has Hattrick Supporter.

Dress (Within Team)
7 character string representing the dress of the team: First characters is a letter indicating type pf dress. Next two numbers indicate the shirt colour, next two indicate pants colour and final two numbers indicate socks colour.

DressAlternate (Within Team)
Same as dress, except that it shows the alternate dress.

BotStatus (Within Team)
Container for the data indicating if a team is a "bot", that is, has a default and random lineup and players.

IsBot (Within BotStatus)
Boolean. Specifies whether a team is currently a bot or not.

BotSince (Within BotStatus)
The date when the team was made a bot, or 1997-08-30 if the team was made a bot before 2005-12-08. If the team is not a bot, this will return 1900-01-01.

TeamRank (Within Team)
If the team has an owner, this is the League Rank, a number based on LeagueLevel, postion etc, only counting teams with an owner. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Note: Date format is always YYYY-MM-DD HH:MM:SS.

Examples

Requests may be posted as either GET or POST.

Get the data for a specified team
teamDetails.asp?outputType=XML&actionType=view&teamID=373

Get the data for your own team
teamDetails.asp?outputType=XML&actionType=view

CHPP Development/XML/teamDetails

2006-10-16T02:48:19Z

Neohugin:

It appears that the custom dress kit resets the chpp settings for Dress and DressAlternate.
This page offers XML and HTML interfaces to see the basic data for a team. The XML interface enables CHPP developers to integrate these data into their applications.

{{CHPP Documentation}}

== Current version ==
This documentation applies to version 1.7 of the XML output.

== Syntax ==
teamDetails.asp?
outputType = {HTML | XML}
actionType = {view}
[{teamID = integer |
userID = 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 basic team data.

teamID
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted.

userID
What team/user to show the data for. teamID and userID generates the same result, except that ownerless teams can only be accessed if submitting a teamID and that users without a team can only be accessed if userID is submitted. If neither userID or teamID is supplied, userID defaults to the logged on user's userID.

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.

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

Version
The current version number of the XML output.

FetchedDate (Within HattrickData)
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

User (Within HattrickData)
Container for the data about the user ("owner").

UserID (Within User)
The globally unique UserID for the owner of the team. Teams without an owner have UserID = 0.

Language (Within User)
Container for the data about the language the user has chosen as his/her default language.

LanguageID (Within Language)
The globally unique LanguageID.

LanguageName (Within Language)
The Language name.

HasSupporter (Within User)
Boolean value indicating whether the user is currently a Hattrick Supporter. Not supplied if the team is ownerless.

Loginname (Within User)
The "username" or "nickname" used in conferences and for login. Not supplied if the team is ownerless.

Name (Within User)
The user's personal name or the value HIDDEN to indicate that the user has chosen to hide it. Not supplied if the team is ownerless.

ICQ (Within User)
The user's ICQ number (if any). Not supplied if the team is ownerless.

SignupDate (Within User)
The date and time when the user signed up for Hattrick. Not supplied if the team is ownerless.

ActivationDate (Within User)
The date and time when the user gained control of this team. Not supplied if the team is ownerless.

LastLoginDate (Within User)
The date and time when the user last logged on. Not supplied if the team is ownerless.

NationalTeamCoach (Within User)
Container for the national teams. An attribute named Count specifies how many national teams this user coaches. If 0, the child node does not exist.

NationalTeam (Within NationalTeamCoach)
Container for a National Team. An attribute called Index signifies the number of the national team in the list (not to be confused with NationalTeamID which is globally unique). Index ranges from 0 to (Count - 1).

NationalTeamID (Within NationalTeam)
The globally unique identifier of the national team.

NationalTeamName (Within NationalTeam)
The name of the national team

Team (Within HattrickData)
Container for the data about the team (not supplied for user without team).

TeamID (Within Team)
The globally unique TeamID.

TeamName (Within Team)
The full team name.

ShortTeamName (Within Team)
The short team name.

Arena (Within Team)
Container for the data about the team's home ground.

ArenaID (Within Arena)
The globally unique ArenaID.

ArenaName (Within Arena)
The arena name.

League (Within Team)
Container for the data about the league ("Sverige", "England" and so on) the team is part of.

LeagueID (Within League)
The globally unique LeagueID.

LeagueName (Within League)
The League name.

Region (Within Team)
Container for the data about the region theteam is located in.

RegionID (Within Region)
The globally unique RegionID.

RegionName (Within Region)
The Region name.

Trainer (Within Team)
The player that is trainer ("coach") for the team. (Not to be confused with the "owner"/"user").

PlayerID (Within Trainer)
The globally unique PlayerID of the player that has the job as trainer of the team.

PlayerName (Within Trainer)
The name of the trainer.

HomePage (Within Team)
The home page URL that the team has specified.

Clubhouse (Within Team)
Exists only if the team has a Clubhouse and if so holds the name of that clubhouse. The URL of the clubhouse will then be http://club.hattrick.org/ClubhouseName/ where ClubhouseName is a placeholder for the value in tag Clubhouse.

Cup (Within Team)
Data about the team's cup status. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

StillInCup (Within Cup)
Boolean value stating if the team is still in the cup.

CupID (Within Cup)
The globally unique CupID of the cup that the team is still in. Only provided if team is still in cup.

CupName (Within Cup)
The name of the cup that the team is still in. Only provided if team is still in cup.

FriendlyBooked (Within Team)
This element is obsolete and will probably be removed within 1-2 months.
The team's status about if friendly is booked. The value is true if team has booked a friendly, false if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

FriendlyTeamID (Within Team)
The team's status about if a friendly is booked. The value is the opponents globally unique teamID if the team has booked a friendly, 0 if not. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

LeagueLevelUnit (Within Team)
Data about the team's LeagueLevelUnit ("series"). If the team is playing a qualification match, an attribute named Available is set to false and the container is empty, otherwise to true.

LeagueLevelUnitID (Within LeagueLevelUnit)
The globally unique LeagueLevelUnitID.

LeagueLevelUnitName (Within LeagueLevelUnit)
The name of the LeagueLevelUnit.

LeagueLevel (Within LeagueLevelUnit)
Integer value stating the relative level of the LeagueLevelUnit, with 1 indicating the league's top series.

NumberOfVictories (Within Team)
If the team is in a winning streak of at least 2 matches, this integer indicates how many victories in a row it currently has. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

NumberOfUndefeated (Within Team)
If the team is in a streak of at least 2 matches as undefeated, this integer indicates how many matches in a row it is undefeated. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

LogoURL (Within Trainer)
The logo URL that the team has specified. Only supplied if the user has Hattrick Supporter

Fanclub (Within Team)
Container for the data about the team's fanclub. Only supplied if the user has Hattrick Supporter.

FanclubID (Within Fanclub)
The globally unique FanclubID. Only supplied if the user has Hattrick Supporter.

FanclubName (Within Fanclub)
The name of the fanclub. Only supplied if the user has Hattrick Supporter.

Guestbook (Within Team)
Container for the data about the user's guestbook. Only supplied if the user has Hattrick Supporter.

NumberOfGuestbookItems (Within Guestbook)
The number of postings in the user's guestbook. Only supplied if the user has Hattrick Supporter.

PressAnnouncement (Within Team)
Container for the data about the user's most recent PressAnnouncement. Only supplied if the user has Hattrick Supporter.

Subject (Within PressAnnouncement)
The subject text specified for the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

Body (Within PressAnnouncement)
The body of the PressAnnouncement. Only supplied if the user has Hattrick Supporter.

SendDate (Within PressAnnouncement)
The time and date when the PressAnnouncement was submitted. Only supplied if the user has Hattrick Supporter.

Dress (Within Team)
7 character string representing the dress of the team: First characters is a letter indicating type pf dress. Next two numbers indicate the shirt colour, next two indicate pants colour and final two numbers indicate socks colour.

DressAlternate (Within Team)
Same as dress, except that it shows the alternate dress.

BotStatus (Within Team)
Container for the data indicating if a team is a "bot", that is, has a default and random lineup and players.

IsBot (Within BotStatus)
Boolean. Specifies whether a team is currently a bot or not.

BotSince (Within BotStatus)
The date when the team was made a bot, or 1997-08-30 if the team was made a bot before 2005-12-08. If the team is not a bot, this will return 1900-01-01.

TeamRank (Within Team)
If the team has an owner, this is the League Rank, a number based on LeagueLevel, postion etc, only counting teams with an owner. If the team is playing a match, an attribute named Available is set to false and the container is empty, otherwise to true.

Note: Date format is always YYYY-MM-DD HH:MM:SS.

Examples

Requests may be posted as either GET or POST.

Get the data for a specified team
teamDetails.asp?outputType=XML&actionType=view&teamID=373

Get the data for your own team
teamDetails.asp?outputType=XML&actionType=view

CHPP Development/XML/worldDetails

2006-10-16T00:29:17Z

Neohugin:

This page offers XML and HTML interfaces that presents some overview and global data used in Hattrick, including lists of all leagues. The XML interface enables CHPP developers to integrate these data into their applications.

{{CHPP Documentation}}

== Current version ==
Current version of the XML output is 1.2

== Syntax ==
worldDetails.asp?
outputType = {HTML | XML}
actionType = {leagues | languages}

== 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.
{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| leagues
| Default
| Show a list of all leagues.
|- bgcolor="#dddddd" valign="top"
| languages
|
| Show a list of all languages.
|}

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== LanguageList (Within HattrickData) ===
Container for the list of languages. An Attribute named Count specifies how many languages it contains. Only provided for actionType = languages. Most languages are not user languages, but since some of them may at some future point become so, the full list is provided. Most of the languages are only used in relation to player's, to determine their names and only show up in the "I speak..." statement on playerDetails.

=== Language (Within LanguageList) ===
Container for the data about a particular language. An Attribute named Index works as a counter.

=== LanguageID (Within Language) ===
The globally unique LanguageID.

=== LanguageName (Within Language) ===
The Language name.

=== LeagueList (Within HattrickData) ===
Container for the list of leagues. An Attribute named Count specifies how many leagues it contains. Only provided for actionType = leagues.

=== League (Within LeagueList) ===
Container for the league. An Attribute named Index works as a counter.

=== LeagueID (Within League) ===
The globally unique LeagueID.

=== LeagueName (Within League) ===
The League name.

=== Season (Within League) ===
The current season number of the league.

=== MatchRound (Within League) ===
The current match round of the league.

=== ShortName (Within League) ===
The short name of the league (used in some places with little room on the site).

=== Continent (Within League) ===
The name of the continent it is defined to be part of in Hattrick.

=== ZoneName (Within League) ===
The name of the zone the league is defined to be part of in Hattrick.

=== EnglishName (Within League) ===
The English name of the league.

=== Country (Within League) ===
Container for the country that is related to the league. It may seem confusing what the difference is between a league and a country. Well, there isn't much, except that in some cases we refer to CountryID instead of LeagueID. The easiest way to deal with it is perhaps to just say: "It's the way it is. Just learn to live with it.". Some things are formally tied to the Country instead of the League. We have chosen to maintain that relationship in the XML output, hence the sub-containers of Country.

=== CountryID (Within Country) ===
The globally unique CountryID of country.

=== CountryName (Within Country) ===
The name of the country.

=== CurrencyName (Within Country) ===
The name of the currency in this country.

=== CurrencyRate (Within Country) ===
Decimal value specifying the relative currency rate.

=== Cup (Within League) ===
Data about the league's default cup.

=== CupID (Within Cup) ===
The globally unique CupID

=== CupName (Within Cup) ===
The name of the cup.

=== ActiveUsers (Within League) ===
Integer specifying the number of active users in the league, as of last daily count.

=== WaitingUsers (Within League) ===
Integer specifying the number of users on the waiting list in the league. These users are not included in the ActiveUsers, so ActiveUsers + WaitingUsers would give a sort of total number of users.

=== TrainingDate (Within League) ===
The date and time when the next training update will start in this league.

=== EconomyDate (Within League) ===
The date and time when the next economy update will start in this league.

=== CupMatchDate (Within League) ===
The date and time when the next cup round is being checked for (that is, there are not necessarily any matches to play, if the cup has been finished).

=== SeriesMatchDate (Within League) ===
The date and time when the next series match round starts. Some leagues may have several series match dates - then this data gives the date when the first batch for the league starts.

=== NumberOfLevels (Within League) ===
Integer representing the number of LeagueLevels (divisions) active for this league.

== Examples ==
Requests may be posted as either GET or POST.

=== Get a list of all leagues and some relevant information about each ===
worldDetails.asp?outputType=XML&actionType=leagues

=== Get a list of all languages ===
worldDetails.asp?outputType=XML&actionType=languages

CHPP Development/XML/matches

2006-10-16T00:19:40Z

Neohugin:

This page offers XML and HTML interfaces to see the the moste recent and upcoming '''matches''' for a particular team. The XML interface enables CHPP developers to integrate these data into their applications.

{{CHPP Documentation}}

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the match list of the team.
|- bgcolor="#dddddd" valign="top"
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! MatchType
! Description
|- bgcolor="#dddddd" valign="top"
| 1
| League match.
|- bgcolor="#dddddd" valign="top"
| 2
| Qualification match.
|- bgcolor="#dddddd" valign="top"
| 3
| Cup match (standard league cup).
|- bgcolor="#dddddd" valign="top"
| 4
| Friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 5
| Friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|- bgcolor="#dddddd" valign="top"
| 7
| Hattrick Masters
|- bgcolor="#dddddd" valign="top"
| 8
| International friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 9
| International friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 10
| National teams competition match (normal rules).
|- bgcolor="#dddddd" valign="top"
| 11
| National teams competition match (cup rules).
|- bgcolor="#dddddd" valign="top"
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

Template:CHPP Documentation

2006-10-16T00:15:32Z

Neohugin:

{| cellpadding="0" cellspacing="0" style="background-color: transparent; border: 1px solid #ccc; padding: 5px; font-size:85%;" class="noprint"
|-
| '''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.
|- style="color: red; font-weight: bold;"
| Only the XML version of this file may be included in CHPP applications.
|}

<includeonly>[[Category:CHPP Documentation]]</includeonly>

CHPP Development/XML/players

2006-10-16T00:15:12Z

Neohugin:

This page offers XML and HTML interfaces to the list of '''players''' for a team. The XML interface enables CHPP developers to integrate these data into their applications.

{{CHPP Documentation}}

== Current version ==
Current version of the XML output is 1.2.6

== Syntax ==
players.asp?
outputType = {HTML | XML}
actionType = {view | viewOldies | supporterStats}
[orderBy = {PlayerNumber | Lastname | PlayerID | Age | MarketValue}]
[teamID = integer]
[matchTypeCategory = {ALL | LQC | F | NT | WC}]
[showAll = {false | true}]

== 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the list of players belonging to a team.
|- bgcolor="#dddddd" valign="top"
| viewOldies
|
| View the list of players who no longer belong to the club but were promoted from the youth squad of this team, or who were part of the start-up squad of the team.
|- bgcolor="#dddddd" valign="top"
| supporterStats
|
| Show players who have played matches for the team, ordered by the number of matches they have played for the team. Requires that the logged on user is a Hattrick Supporter.
|- bgcolor="#dddddd" valign="top"
| orderBy
|
| The field that the outdata PlayerList should be sorted by. Not relevant for actionType = supporterStats.
|}

=== teamID ===
The team for which the data should apply to. Defaults to the logged on user's own TeamID if not supplied.

=== matchTypeCategory ===
Only relevant for actionType = supporterStats. Indicates one of the following types of matches:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| ALL
| Default
| All matches.
|- bgcolor="#dddddd" valign="top"
| LQC
|
| League, qualification and cup matches.
|- bgcolor="#dddddd" valign="top"
|F
|
|Friendlies only.
|}

=== showAll ===
Boolean value only relevant for actionType supporterStats. Defaults to false, which means that only the 20 players with most matches are shown. If true, all players are returned.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
Container for the team to which the data applies.

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== PlayerList (Within Team) ===
Container for the list of players. An Attribute named Count specifies how many players it contains.

=== Player (Within PlayerList) ===
Container for a player. An Attribute named Index works as a counter.

=== 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.

=== Age (Within Player) ===
The age of the player.

=== TSI (Within Player) ===
The Total Skill Index (TSI) of the player.

=== PlayerForm (Within Player) ===
The current form, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

=== Statement (Within Player) ===
If the owner is a HT Supporter, he may have provided a Statement from his players.

=== 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.

=== Salary (Within Player) ===
The salary of the player, given in the default currence (Currency rate 1. There are 10 default currency units per US$).

=== 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.

=== 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 (se Denominations appendix of rules).

=== Honesty (Within Player) ===
The honesty of the player, given as an integer with 1 indicating the lowest level (se Denominations appendix of rules).

=== LeagueGoals (Within Player) ===
The number of goals in the league this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== FriendliesGoals (Within Player) ===
The number of goals in friendlies this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== CareerGoals (Within Player) ===
The total number goals throughout this player's carreer. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of hattricks. Please note that some of these data have become somewhat corrupt over the years, something that cannot be fixed.

=== Specialty (Within Player) ===
Integer indicating the specialty (if any) of the player:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Description
|- bgcolor="#dddddd" valign="top"
| 0
| No specialty.
|- bgcolor="#dddddd" valign="top"
| 1
| Technical.
|- bgcolor="#dddddd" valign="top"
| 2
| Quick.
|- bgcolor="#dddddd" valign="top"
| 3
| Powerful.
|- bgcolor="#dddddd" valign="top"
| 4
| Unpredictable.
|- bgcolor="#dddddd" valign="top"
| 5
| Head specialist.
|}

=== TransferListed (Within Player) ===
Returns 1 if the player is on the transfer list, otherwise 0.

=== NationalTeamID (Within Player) ===
If the player is enrolled on a national team, this is that national team's ID. Otherwise will return 0.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of cards.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual InjuryLevel.

=== StaminaSkill (Within Player) ===
The stamina skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== KeeperSkill (Within Player) ===
The keeper skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PlaymakerSkill (Within Player) ===
The playmaker skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== ScorerSkill (Within Player) ===
The scorer skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PassingSkill (Within Player) ===
The passing skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== WingerSkill (Within Player) ===
The winger skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== DefenderSkill (Within Player) ===
The defender skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== SetPiecesSkill (Within Player) ===
The set pieces skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== OwningTeam (Within Player) ===
Container for the team that owns the player. Only provided for actionType viewOldies.

=== 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.

=== LeagueName (Within OwningTeam) ===
The name of the league that team owning the player is located in.

=== 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.

=== TrainerType (Within TrainerData) ===
Integer indicating the type of trainer:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Description
|- bgcolor="#dddddd" valign="top"
| 0
| Defensive
|- bgcolor="#dddddd" valign="top"
| 1
| Offensive
|- bgcolor="#dddddd" valign="top"
| 2
| Balanced
|}

=== TrainerSkill (Within TrainerData) ===
The trainer skill, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

=== CountryID (Within Player) ===
The CountryID that the player is native of. This is the value that is used to identify what national team the player can be enrolled to. Please note that CountryID is often not the same as LeagueID. You can use (for instance) worldDetails.asp to map a certain CountryID to a LeagueID.

=== 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.

== Examples ==
Requests may be posted as either GET or POST.

=== Get a list of all players for your own team ===
players.asp?outputType=XML&actionType=view

=== Get a list of players that were brought up in a team (but is no longer in the team) ===
players.asp?outputType=XML&actionType=viewOldies&teamID=373

=== Get a list of all players that have played a competition match (League, Qual. cup) for your team ===
players.asp?outputType=XML&actionType=supporterStats&matchTypeCategory=LQC&showAll=true

Template:CHPP Documentation

2006-10-15T23:35:52Z

Neohugin:

CHPP Development/XML/players

2006-10-15T22:15:29Z

Neohugin:

This page offers XML and HTML interfaces to the list of '''players''' for a team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 1.2.6

== Syntax ==
players.asp?
outputType = {HTML | XML}
actionType = {view | viewOldies | supporterStats}
[orderBy = {PlayerNumber | Lastname | PlayerID | Age | MarketValue}]
[teamID = integer]
[matchTypeCategory = {ALL | LQC | F | NT | WC}]
[showAll = {false | true}]

== 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the list of players belonging to a team.
|- bgcolor="#dddddd" valign="top"
| viewOldies
|
| View the list of players who no longer belong to the club but were promoted from the youth squad of this team, or who were part of the start-up squad of the team.
|- bgcolor="#dddddd" valign="top"
| supporterStats
|
| Show players who have played matches for the team, ordered by the number of matches they have played for the team. Requires that the logged on user is a Hattrick Supporter.
|- bgcolor="#dddddd" valign="top"
| orderBy
|
| The field that the outdata PlayerList should be sorted by. Not relevant for actionType = supporterStats.
|}

=== teamID ===
The team for which the data should apply to. Defaults to the logged on user's own TeamID if not supplied.

=== matchTypeCategory ===
Only relevant for actionType = supporterStats. Indicates one of the following types of matches:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| ALL
| Default
| All matches.
|- bgcolor="#dddddd" valign="top"
| LQC
|
| League, qualification and cup matches.
|- bgcolor="#dddddd" valign="top"
|F
|
|Friendlies only.
|}

=== showAll ===
Boolean value only relevant for actionType supporterStats. Defaults to false, which means that only the 20 players with most matches are shown. If true, all players are returned.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
Container for the team to which the data applies.

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== PlayerList (Within Team) ===
Container for the list of players. An Attribute named Count specifies how many players it contains.

=== Player (Within PlayerList) ===
Container for a player. An Attribute named Index works as a counter.

=== 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.

=== Age (Within Player) ===
The age of the player.

=== TSI (Within Player) ===
The Total Skill Index (TSI) of the player.

=== PlayerForm (Within Player) ===
The current form, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

=== Statement (Within Player) ===
If the owner is a HT Supporter, he may have provided a Statement from his players.

=== 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.

=== Salary (Within Player) ===
The salary of the player, given in the default currence (Currency rate 1. There are 10 default currency units per US$).

=== 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.

=== 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 (se Denominations appendix of rules).

=== Honesty (Within Player) ===
The honesty of the player, given as an integer with 1 indicating the lowest level (se Denominations appendix of rules).

=== LeagueGoals (Within Player) ===
The number of goals in the league this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== FriendliesGoals (Within Player) ===
The number of goals in friendlies this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== CareerGoals (Within Player) ===
The total number goals throughout this player's carreer. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of hattricks. Please note that some of these data have become somewhat corrupt over the years, something that cannot be fixed.

=== Specialty (Within Player) ===
Integer indicating the specialty (if any) of the player:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Description
|- bgcolor="#dddddd" valign="top"
| 0
| No specialty.
|- bgcolor="#dddddd" valign="top"
| 1
| Technical.
|- bgcolor="#dddddd" valign="top"
| 2
| Quick.
|- bgcolor="#dddddd" valign="top"
| 3
| Powerful.
|- bgcolor="#dddddd" valign="top"
| 4
| Unpredictable.
|- bgcolor="#dddddd" valign="top"
| 5
| Head specialist.
|}

=== TransferListed (Within Player) ===
Returns 1 if the player is on the transfer list, otherwise 0.

=== NationalTeamID (Within Player) ===
If the player is enrolled on a national team, this is that national team's ID. Otherwise will return 0.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of cards.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual InjuryLevel.

=== StaminaSkill (Within Player) ===
The stamina skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== KeeperSkill (Within Player) ===
The keeper skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PlaymakerSkill (Within Player) ===
The playmaker skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== ScorerSkill (Within Player) ===
The scorer skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PassingSkill (Within Player) ===
The passing skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== WingerSkill (Within Player) ===
The winger skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== DefenderSkill (Within Player) ===
The defender skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== SetPiecesSkill (Within Player) ===
The set pieces skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== OwningTeam (Within Player) ===
Container for the team that owns the player. Only provided for actionType viewOldies.

=== 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.

=== LeagueName (Within OwningTeam) ===
The name of the league that team owning the player is located in.

=== 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.

=== TrainerType (Within TrainerData) ===
Integer indicating the type of trainer:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Description
|- bgcolor="#dddddd" valign="top"
| 0
| Defensive
|- bgcolor="#dddddd" valign="top"
| 1
| Offensive
|- bgcolor="#dddddd" valign="top"
| 2
| Balanced
|}

=== TrainerSkill (Within TrainerData) ===
The trainer skill, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

=== CountryID (Within Player) ===
The CountryID that the player is native of. This is the value that is used to identify what national team the player can be enrolled to. Please note that CountryID is often not the same as LeagueID. You can use (for instance) worldDetails.asp to map a certain CountryID to a LeagueID.

=== 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.

== Examples ==
Requests may be posted as either GET or POST.

=== Get a list of all players for your own team ===
players.asp?outputType=XML&actionType=view

=== Get a list of players that were brought up in a team (but is no longer in the team) ===
players.asp?outputType=XML&actionType=viewOldies&teamID=373

=== Get a list of all players that have played a competition match (League, Qual. cup) for your team ===
players.asp?outputType=XML&actionType=supporterStats&matchTypeCategory=LQC&showAll=true

CHPP Development/XML/players

2006-10-15T22:03:42Z

Neohugin:

This page offers XML and HTML interfaces to the list of '''players''' for a team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 1.2.6

== Syntax ==
players.asp?
outputType = {HTML | XML}
actionType = {view | viewOldies | supporterStats}
[orderBy = {PlayerNumber | Lastname | PlayerID | Age | MarketValue}]
[teamID = integer]
[matchTypeCategory = {ALL | LQC | F | NT | WC}]
[showAll = {false | true}]

== 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 list of players belonging to a team.
viewOldies View the list of players who no longer belong to the club but were promoted from the youth squad of this team, or who were part of the start-up squad of the team.
supporterStats Show players who have played matches for the team, ordered by the number of matches they have played for the team. Requires that the logged on user is a Hattrick Supporter.
orderBy
The field that the outdata PlayerList should be sorted by. Not relevant for actionType = supporterStats.

=== teamID ===
The team for which the data should apply to. Defaults to the logged on user's own TeamID if not supplied.

=== matchTypeCategory ===
Only relevant for actionType = supporterStats. Indicates one of the following types of matches:
Value Default Description
ALL Default All matches.
LQC League, qualification and cup matches.
F Friendlies only.

=== showAll ===
Boolean value only relevant for actionType supporterStats. Defaults to false, which means that only the 20 players with most matches are shown. If true, all players are returned.

== 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.

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

=== Version ===
The current version number of the XML output.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
Container for the team to which the data applies.

=== TeamID (Within Team) ===
The globally unique TeamID.

=== TeamName (Within Team) ===
The full team name.

=== PlayerList (Within Team) ===
Container for the list of players. An Attribute named Count specifies how many players it contains.

=== Player (Within PlayerList) ===
Container for a player. An Attribute named Index works as a counter.

=== 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.

=== Age (Within Player) ===
The age of the player.

=== TSI (Within Player) ===
The Total Skill Index (TSI) of the player.

=== PlayerForm (Within Player) ===
The current form, given as an integer with 1 indicating disastrous, 2 for wretched and so on.

=== Statement (Within Player) ===
If the owner is a HT Supporter, he may have provided a Statement from his players.

=== 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.

=== Salary (Within Player) ===
The salary of the player, given in the default currence (Currency rate 1. There are 10 default currency units per US$).

=== 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.

=== 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 (se Denominations appendix of rules).

=== Honesty (Within Player) ===
The honesty of the player, given as an integer with 1 indicating the lowest level (se Denominations appendix of rules).

=== LeagueGoals (Within Player) ===
The number of goals in the league this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== FriendliesGoals (Within Player) ===
The number of goals in friendlies this season. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. Please note that some of these data can sometimes be somewhat corrupt.

=== CareerGoals (Within Player) ===
The total number goals throughout this player's carreer. If the team the player belongs to is currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of goals. 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of hattricks. Please note that some of these data have become somewhat corrupt over the years, something that cannot be fixed.

=== 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.

=== TransferListed (Within Player) ===
Returns 1 if the player is on the transfer list, otherwise 0.

=== NationalTeamID (Within Player) ===
If the player is enrolled on a national team, this is that national team's ID. Otherwise will return 0.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual number of cards.

=== 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 currently playing a match, a string with value NOT AVAILABLE is returned instead of the actual InjuryLevel.

=== StaminaSkill (Within Player) ===
The stamina skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== KeeperSkill (Within Player) ===
The keeper skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PlaymakerSkill (Within Player) ===
The playmaker skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== ScorerSkill (Within Player) ===
The scorer skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== PassingSkill (Within Player) ===
The passing skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== WingerSkill (Within Player) ===
The winger skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== DefenderSkill (Within Player) ===
The defender skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== SetPiecesSkill (Within Player) ===
The set pieces skill of the player, given as an integer with 1 indicating disastrous, 2 for wretched and so on. Only provided if the player belongs to the logged on user.

=== OwningTeam (Within Player) ===
Container for the team that owns the player. Only provided for actionType viewOldies.

=== 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.

=== LeagueName (Within OwningTeam) ===
The name of the league that team owning the player is located in.

=== 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.

=== 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.

=== CountryID (Within Player) ===
The CountryID that the player is native of. This is the value that is used to identify what national team the player can be enrolled to. Please note that CountryID is often not the same as LeagueID. You can use (for instance) worldDetails.asp to map a certain CountryID to a LeagueID.

=== 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.

== Examples ==
Requests may be posted as either GET or POST.

=== Get a list of all players for your own team ===
players.asp?outputType=XML&actionType=view Try

=== Get a list of players that were brought up in a team (but is no longer in the team) ===
players.asp?outputType=XML&actionType=viewOldies&teamID=373 Try

=== Get a list of all players that have played a competition match (League, Qual. cup) for your team ===
players.asp?outputType=XML&actionType=supporterStats&matchTypeCategory=LQC&showAll=true Try

CHPP Development/XML/matches

2006-10-15T21:57:29Z

Neohugin:

This page offers XML and HTML interfaces to see the the moste recent and upcoming '''matches''' for a particular team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the match list of the team.
|- bgcolor="#dddddd" valign="top"
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! MatchType
! Description
|- bgcolor="#dddddd" valign="top"
| 1
| League match.
|- bgcolor="#dddddd" valign="top"
| 2
| Qualification match.
|- bgcolor="#dddddd" valign="top"
| 3
| Cup match (standard league cup).
|- bgcolor="#dddddd" valign="top"
| 4
| Friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 5
| Friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|- bgcolor="#dddddd" valign="top"
| 7
| Hattrick Masters
|- bgcolor="#dddddd" valign="top"
| 8
| International friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 9
| International friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 10
| National teams competition match (normal rules).
|- bgcolor="#dddddd" valign="top"
| 11
| National teams competition match (cup rules).
|- bgcolor="#dddddd" valign="top"
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

CHPP Development/XML/matches

2006-10-15T21:52:07Z

Neohugin:

This page offers XML and HTML interfaces to see the the moste recent and upcoming '''matches''' for a particular team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! Value
! Default
! Description
|- bgcolor="#dddddd" valign="top"
| view
| Default
| View the match list of the team.
|- bgcolor="#dddddd" valign="top"
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

=== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="0" cellpadding="2" cellspacing="2"
|- bgcolor="#cccccc" align="left"
! MatchType
! Description
|- bgcolor="#dddddd" valign="top"
| 1
| League match.
|- bgcolor="#dddddd" valign="top"
| 2
| Qualification match.
|- bgcolor="#dddddd" valign="top"
| 3
| Cup match (standard league cup).
|- bgcolor="#dddddd" valign="top"
| 4
| Friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 5
| Friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|- bgcolor="#dddddd" valign="top"
| 7
| Hattrick Masters
|- bgcolor="#dddddd" valign="top"
| 8
| International friendly (normal rules).
|- bgcolor="#dddddd" valign="top"
| 9
| International friendly (cup rules).
|- bgcolor="#dddddd" valign="top"
| 10
| National teams competition match (normal rules).
|- bgcolor="#dddddd" valign="top"
| 11
| National teams competition match (cup rules).
|- bgcolor="#dddddd" valign="top"
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

CHPP Development/XML/matches

2006-10-15T21:33:27Z

Neohugin:

This page offers XML and HTML interfaces to see the the moste recent and upcoming '''matches''' for a particular team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="1" width="75%"
|-
! Value
! Default
! Description
|-
| view
| Default
| View the match list of the team.
|-
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

=== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="1" width="75%"
|-
! MatchType
! Description
|-
| 1
| League match.
|-
| 2
| Qualification match.
|-
| 3
| Cup match (standard league cup).
|-
| 4
| Friendly (normal rules).
|-
| 5
| Friendly (cup rules).
|-
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|-
| 7
| Hattrick Masters
|-
| 8
| International friendly (normal rules).
|-
| 9
| International friendly (cup rules).
|-
| 10
| National teams competition match (normal rules).
|-
| 11
| National teams competition match (cup rules).
|-
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

CHPP Development/XML/matches

2006-10-15T21:23:18Z

Neohugin:

This page offers XML and HTML interfaces to see the the moste recent and upcoming matches for a particular team. The XML interface enables CHPP developers to integrate these data into their applications.

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="1" width="75%"
|-
! Value
! Default
! Description
|-
| view
| Default
| View the match list of the team.
|-
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

=== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="1" width="75%"
|-
! MatchType
! Description
|-
| 1
| League match.
|-
| 2
| Qualification match.
|-
| 3
| Cup match (standard league cup).
|-
| 4
| Friendly (normal rules).
|-
| 5
| Friendly (cup rules).
|-
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|-
| 7
| Hattrick Masters
|-
| 8
| International friendly (normal rules).
|-
| 9
| International friendly (cup rules).
|-
| 10
| National teams competition match (normal rules).
|-
| 11
| National teams competition match (cup rules).
|-
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

CHPP Development/XML/matches

2006-10-15T21:20:59Z

Neohugin:

== Current version ==
Current version of the XML output is 2.2

== Syntax ==
matches.asp?
outputType = {HTML | XML}
actionType = {view | refreshCache}
[teamID = integer]
[LastMatchDate = Date]

== 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.

{| border="1" width="75%"
|-
! Value
! Default
! Description
|-
| view
| Default
| View the match list of the team.
|-
| refreshCache
|
| Force the server to load the match data directly from the database instead of using the cache files that are normally used.
'''Important:''' Do not abuse this option. Excessive use of this option may force us to close it for XML/CHPP access. The cache files have intelligently chosen expiry dates and are normally fully up to date. Use of the refreshCache option should be restricted to something that happens when the end user actively choses to do so. And it should never be used more than once in 15 minutes.
|}

=== teamID ===
What team to show the matches for.

=== LastMatchDate ===
Last date to show matches to. If not set, default is 28 days in the future. If more than 50 matches are affected, only the 50 first will be returned. This option should not normally be used by CHPPs, since it bypass the cache.

=== 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 ===
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.

=== FetchedDate (Within HattrickData) ===
Date and time when the XML file was fetched. Format is YYYY-MM-DD HH:MM:SS.

=== Team (Within HattrickData) ===
The team that the list applies to.

=== TeamID (Within Team) ===
The team's TeamID.

=== TeamName (Within Team) ===
The full name of the team.

=== MatchList (Within Team) ===
Container for the matches. An attribute named Count specifies how many matches it contains.

=== Match (Within MatchList) ===
A match. An attribute called Index signifies the number of the match in the list (not to be confused with MatchID which is globabbly unique).

=== MatchID (Within Match) ===
The globally unique identifier of the match.

=== HomeTeam (Within Match) ===
The Home (formal, not taking arena location into account) team of the match.

=== HomeTeamID (Within HomeTeam) ===
The teamID of the Home team in the match.

=== HomeTeamName (Within HomeTeam) ===
The team name of the Home team in the match.

=== AwayTeam (Within Match) ===
The away (formal, not taking arena location into account) team of the match.

=== AwayTeamID (Within AwayTeam) ===
The teamID of the away team in the match.

=== AwayTeamName (Within AwayTeam) ===
The team name of the away team in the match.

=== MatchDate (Within Match) ===
The start date (kick-off) of the match.

=== MatchType (Within Match) ===
Integer defining the type of match:

{| border="1" width="75%"
|-
! MatchType
! Description
|-
| 1
| League match.
|-
| 2
| Qualification match.
|-
| 3
| Cup match (standard league cup).
|-
| 4
| Friendly (normal rules).
|-
| 5
| Friendly (cup rules).
|-
| 6
| Not currently in use, but reserved for international competition matches with normal rules (may or may not be implemented at some future point).
|-
| 7
| Hattrick Masters
|-
| 8
| International friendly (normal rules).
|-
| 9
| International friendly (cup rules).
|-
| 10
| National teams competition match (normal rules).
|-
| 11
| National teams competition match (cup rules).
|-
| 12
| National teams friendly.
|}

=== HomeGoals (Within Match) ===
The number of goals for the home team. If the match is still upcoming or ongoing, this tag is not sent.

=== AwayGoals (Within Match) ===
The number of goals for the away team. If the match is still upcoming or ongoing, this tag is not sent.

=== Status (Within Match) ===
A tristate string value specifying whether the match is FINISHED, ONGOING or UPCOMING.

=== OrdersGiven (Within Match) ===
A boolean value only supplied for upcoming matches (haven't started yet) of your own team that signifies whether you have given orders or not. If the request is for another team than your own (even if it is for your opponent), this data is not sent.

== Examples ==
Requests may be posted as either GET or POST.

=== Get the data for a specified team ===
matches.asp?outputType=XML&actionType=view&teamID=373

=== Get the data for your own team ===
matches.asp?outputType=XML&actionType=view

=== Get the data for your own team and order the server to make a cache refresh (please avoid excessive use) ===
matches.asp?outputType=XML&actionType=refreshCache

Coach

2006-07-01T04:44:15Z

Neohugin: /* Training Skill */

The coach is a very important figure in Hattrick, responsible for training speed.

==Abilities of a coach==

===Coach types===

There are three different types of coach: "[[Offensive Coach]]", "[[Defensive Coach]]" or "[[Neutral Coach]]", affecting the teams' performance (and only performance) during the game.

The type of coach that is best for your team will largely depend on your training type. See '''[[Coach tactics]]''' for more information.

Offensive coaches have an attacking nature and therefore stimulate the team to play more offensively. This boosts the teams [[attack ratings]].

Defensive coaches have a defensive nature, and boost the team's [[defence ratings]]. It is often believed they are slightly more effective than offensive coaches

Neutral coaches have no offensive or defensive preference, and therefore boost both the teams attack and defense ratings a little.

=== Training Skill ===

A talented coach knows the right methods of training, allowing young players to improve their abilities faster. [[Training]] (see [[Rules#Training|Chapter 17]]) becomes more effective. The [[Skills#Coach skills / Form / Leadership|skill]] can never be better than excellent.

=== Leadership ===

Even if a coach is good at planning [[training]] activities, he might be a bad [[Leadership|leader]], not inspiring [[players]] to give top performances during [[game]]s. The [[team spirit]] might be spoilt if the coach is a weak leader.

==Changing the coach==
If your coach disappoints you, you can always get a new one. There are two different ways to go:

===Recruit a coach externally===
Recruiting externally basically means that you hire a new coach. However, you first decide how good you want him to be (trainer skill and leadership) and what trainer type you want (one who favours [[Coach tactics#Offensive coach|attack]], [[Coach tactics#Defensive coach|defence]] or is [[Coach tactics#Neutral coach|neutral]]).

Each combination of leadership/trainer skill has a fixed price. Then you "buy" him (he is taken from an unseen pool of unemployed coaches - coaches are not included on the [[transfer list]].

===Use existing player===
This alternative can be somewhat cheaper than the external recruiting - if you have a [[player]] with the right coaching material.

There are a few restrictions: The player's [[experience]] determines how good a coach he can become. Also, the more experienced he is, the lower his price for a certain [[Skills#Coach skills / Form / Leadership|skill]] level. Players keep their [[leadership]] (already known to you) and you do not pay for their leadership - so, if you have a very experienced player with high leadership, this can be a real bargain.

However, to prevent [[daytrading]] of coaches-to-be, we have another restriction: The player must have been in your [[Team|squad]] for a [[season]] (16 weeks) to be eligible to become your coach. While it will still be possible (in principle) to purchase a player in order to make him coach for a little less, it will require more than a season's foresight.

When you hire a new coach, he becomes the coach of your squad (when he arrives, which may take up to a minute after you ordered him) and the old coach stays in the squad (in case you want to keep him as player). If you don't want him, you will have to [[fire]] him. He can never become coach a second time for your team (although he may go to another team eventually). Also, you cannot sell a player who has become coach. This is important, as otherwise people would start trading coaches and that is not the kind of system we want. All new teams get initial coaches who are of equal skill level (weak).

Useful links to check your future coach are:<br>
[http://www.manager.brygge.dk/Hattrick/experience.htm Check the experience of the player you want to make a coach]<br>
[http://introht.com/iht.php?sec=tool-exp&lng=en&menu=4 Calculator which has to be used with the Conversion price of the first side]

==Level of the coach==
All new coaches of a certain skill level are equal. That is, if you purchase a coach with passable skill, he always becomes "average" passable. There is no "high passable" and "low passable". However, the increase in the coaches performance between levels is, like with regular player skills, non-linear. This means that the gap between a solid coach and an excellent coach is smaller than the gap between a passable coach and a solid coach in terms of the effect of the training, so a high-level coach might not always be the best solution for you. The common consensus on this matter is that a solid coach is both affordable and advisable for most managers.

===Skills deterioration===
Coaches will slowly have their leadership skills deteriorate. Deterioration will not start until the coach has been in the club for more than a season. HT's reasoning is a coach that might seem bustling with energy and inspiration when he first arrives, after a few seasons loses some of his "edge". He has simply grown bored with the job.

Finally, once a coach reaches [[disastrous]] leadership (and that would typically take perhaps 10 seasons for a coach starting with solid leadership), the deterioration starts hitting his trainer skills instead of the depleted leadership. Let us underline that the deterioration is very slow, although it will go somewhat faster for coaches with very high leadership, so a solid leader might go down to passable after 1-2 seasons (more likely after 2 seasons or more though).

Players who become coaches have an emergency surgical procedure and if they had any injuries, they are automatically healed!

----
''For documentation on the introducting of the current coach system check [[Hattrick 6.5#New system for coaches|the Hattrick 6.5 documents]].''
[[Category:Game Concepts]]