Fixtures REST Services

Request

Format 1 - Fixtures for a club

URI: http://www.southlacrosse.org.uk/rest/clubs/{club-id}/fixtures[?links=true]

club-id is required (see allowed values).

links is optional. If set to true the following additional attributes are returned for all teams except those in the selected club:

href Website address of the team.
club Link to the team's club webpage at this site.
map Link to a map of the ground. Note: this does not get added to away-team nodes, and for women's fixtures won't be added to home-team nodes if hosts is present.

Note: if a clubs has both men's and women's sections then each fixture will be marked with type="mens" or type="womens".

Format 2 - Fixtures for a type or team

URI: http://www.southlacrosse.org.uk/rest/fixtures/{type}[/team[?links=true]]

type is required, and must be mens or womens.

team is optional (see allowed values), and if omitted then all fixtures will be returned.

links is optional, and can only be specified if a team is supplied. See above for details.

Response Samples

Men's

Request URI: http://www.southlacrosse.org.uk/rest/fixtures/mens/Purley

Response data (edited for brevity):

<?xml version="1.0"?>
<fixtures created="2011-07-25T12:00:00">
  <fixture>
    <date>2011-10-01</date>
    <home-team>Purley</home-team>
    <away-team>Hillcroft</away-team>
    <competition>Prem</competition>
  </fixture>
  <fixture>
    <date>2011-10-08</date>
    <home-team>Cardiff Harlequins</home-team>
    <away-team>Purley</away-team>
    <competition>Prem</competition>
  </fixture>
...
  <fixture>
    <date>2011-10-29</date>
    <home-team>Welwyn Warriors</home-team>
    <away-team>Purley</away-team>
    <competition>Prem</competition>
    <time>1:30pm</time>
  </fixture>
...
  <fixture>
    <date>2012-04-21</date>
    <competition>Flags Final</competition>
  </fixture>
</fixtures>

Note that:

time tags are optional. The default time for men's games is 2:00pm.
Some fixtures only contain a competition, i.e. without home or away teams. This is either for tournaments (where many teams are competing), or for round robin competitions where later rounds are yet to be decided (such at the flags), or for events which all teams should be aware of.
Women's fixtures also return hosts and umpire fields - see below
For Women's games the the home team is determined by the hosts field. home-team and away-team tag names are used to keep consistent with men's fixtures.

Women's

Request URI: http://www.southlacrosse.org.uk/rest/fixtures/womens/Centaurs

Response data (edited for brevity):

<?xml version="1.0"?>
<fixtures created="2011-07-25T12:00:00">
  <fixture>
    <date>2011-09-25</date>
    <home-team>Harpenden</home-team>
    <away-team>Centaurs</away-team>
    <competition>Prem</competition>
    <umpire>West London</umpire>
    <hosts>Harpenden</hosts>
    <time>11:00 AM</time>
  </fixture>
  <fixture>
    <date>2011-10-02</date>
    <home-team>West London</home-team>
    <away-team>Centaurs</away-team>
    <competition>Prem</competition>
    <umpire>Blues</umpire>
    <hosts>Blues</hosts>
    <time>12:30 PM</time>
  </fixture>
  ...
  <fixture>
    <date>2011-10-22</date>
    <competition>South Clubs and Colleges Tournament</competition>
    <hosts>Cougars</hosts>
  </fixture>
  ...
</fixtures>

For women's tournaments the hosts field is optional.

With Additional Link Attributes

Request URI: http://www.southlacrosse.org.uk/rest/fixtures/mens/Purley?links=true

Response data (edited for clarity/brevity):

<?xml version="1.0"?>
<fixtures created="2011-07-25T12:00:00">
  <fixture>
    <date>2011-10-01</date>
    <home-team>Purley</home-team>
    <away-team href="http://www.hillcroftlax.co.uk/"
      club="http://www.southlacrosse.org.uk/clubs/hillcroft.html">
        Hillcroft
    </away-team>
    <competition>Prem</competition>
  </fixture>
  <fixture>
    <date>2011-10-08</date>
    <home-team href="http://www.cardifflacrosse.co.uk/"
      club="http://www.southlacrosse.org.uk/clubs/harlequins.html"
      map="http://maps.google.co.uk/?q=51.517189,-3.241106(Cardiff+Harlequins+Lacrosse+Club)">
        Cardiff Harlequins
    </home-team>
    <away-team>Purley</away-team>
    <competition>Prem</competition>
  </fixture>
  ...
</fixtures>