Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.
softnetsport
statscore.com/v2/standings/{standing_id}
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/standings.show.xsd
MethodGET

Description

Returns
the
single standings data

Package

This resource is included in the STATISTICS packages
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
standing_idxsd:intREQUIRED. The requested standing identifier

Query parameters

NameTypeDescription
tokenxsd:stringREQUIRED.
More
 More information concerning
oAuth token: oAuth 2.0 authorization
authorization in API introduction section
langxsd:string

Determines language for the output data

. softnetSPORT API provides the following languages: languages.index

 

subparticipant_idxsd:intDetermines unique subparticipant id. Could be neccessary to show
i
e.
e
g. top scorers from
the
a single team
participant_idxsd:stringList of participant identifiers separated by a comma (
f
e.
e
g. 123,234,321) for which you want to get
scoped
results.

Method calling examples

Returns the selected standings in XML formathttps://api.softnetsport.
LinkDescription
https://api.
softnetsport.com/v2/standings/21.xml?token={{YOUR_TOKEN}}
statscore.com/v2/standings/21?token={{YOUR_TOKEN}}Returns the selected standings in JSON format

Output elements

.
standings
 
standings > standing


idUnique identifier for the standings
nameName of the standings
sport_idUnique identifier
of
for the sport in which
standings occures. softnetSPORT API provides the following sports: sports.index
the standings occurres 
sport_nameName of the sport
type_idUnique identifier for the standings type. e.g. Away standings, World Cup standings, Event's final result
type_nameName of standings type.
i
e.
e
g. Standings table, Top scorers, Cards
subtype

Name of subtype of standings. Possible values:

  • standings
  • under_over
  • form
  • overall_stats
object_idUnique identifier for object selected in the object_type
object_type

Type of object (kind of scope) for which data

are

is generated. Possible values:

  • sport (
i
  • e.
e
  • g. WTA Ranking)
  • season (standings
table
  • for England Premiership)
  • stage (standings in second round of competitions)
object_nameName
for
of selected object
i
e.
e
g. European Championship (competition_season), Premier League (competition_season), FC Barcelona (team),
Relegation Round (stage), FC Barcelona - Manchester United (event)
stage_name_idUnique identifier for the stage's name.
item_status

Describes status of the item (record)

utInformation about date and time when the record was last updated. Format UNIX_TIMESTAMP..groups ...group idUnique identifier for group. Could be empty value
nameName of the group. Could be empty value

. Possible values:

  • active - the record is active
  • deleted - the record was deleted by the admin. When an event was added by mistake
reset_group_rank

Describes type of rank in groups. Possible values:

  • yes - (default) each possible group in standings has it's own rank and it starts from value 1
  • no - all possible groups share the same rank e.g. rank in group B could start from the value higher than last value in group A.
competition_idUnique identifier for the competition
season_idUnique identifier for the season
stage_idUnique identifier for the stage
utInformation about the date and time of when the
group
record was last updated. Format UNIX_TIMESTAMP
....participants .....participant idUnique identifier for participantnameName of participantarea_idArea idetifier of participantarea_nameArea name of participantrankPresent rank, place in standingslast_rankLast rank, place in standingszone_nameStandings zone namesubparticipant_idParticipant team identifier (could be empty)subparticipant_nameParticipant team name (could be empty)subparticipant_slugFriendly url for the subparticipant (could be empty)participant_slugFriendly url for the participant.....columns ......column idIdentifier of the columns/statsnameName of the column (title)short_nameShort name of the column (title)valueValue of the column for the single participant....corrections .....correction


standings > standing > groups
standings > standing > groups > group

Include Page
Group node
Group node

standings > standing > groups > group > participants
standings > standing > groups > group > participants > participant

Include Page
Participant node
Participant node

standings > standing > groups > group > participants > participant > columns
standings > standing > groups > group > participants > participant > columns > column

Include Page
Column node
Column node

standings > standing > groups > group > corrections
standings > standing > groups > group > corrections > correction 


participant_idIdentifier
of
for the participant
participant_nameName of the participant
valueCorrection value,
i
e.
e.....zone 
g. "+2"
reason
....zones 

Determines the reason of corrections. Possible reasons:

  • Association decision
  • Disqualified
  • Financial issues
  • Quit
  • Regulations


standings > standing > groups > group > zones
standings > standing > groups > group > zones > zone


idIdentifier for the zone
nameName of the zone
colourThe CSS colour for the zone