Personnel Validation¶

Name Order¶

GET /v1/name_order/(int: ID)¶

Returns the name order conventions for the formation of a person’s full name.

Name Order	Description	Examples
Western	<first name> <last name>	Ryan Giggs, Lionel Messi
Middle	<first name> <middle name> <last name>	Carlos Alberto Rodríguez
Eastern	<last_name> <first_name>	Park Ji-Sung, Sun Jihai

If ID is passed, return data for the name order convention the ID corresponds to.

If query parameters are passed, it returns the record that matches the specified filters.

Warning

This resource cannot be paginated. Any requests with records or page parameters will return a 400 BAD REQUEST error.

Query and Response Parameters:

Field	Type	Description
desc	string	Name order convention.

Example:

GET /v1/name_order HTTP/1.1
Host: api-connect.soccermetrics.net
Accept: application/json

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Server: gunicorn/18.0
Date: Thu, 24 Jul 2014 05:18:43 GMT
Connection: close
Content-Type: application/json
Content-Length: 742

{
  "attribution": {
    "html": "<a href=\"http://www.soccermetrics.net\"><img src=\"http://soccermetrics-connect-v1.s3.amazonaws.com/logo/soccermetrics_logo.png\"/></a>",
    "logo": "http://soccermetrics-connect-v1.s3.amazonaws.com/logo/soccermetrics_logo.png",
    "source": {},
    "text": "Powered by Soccermetrics Research",
    "url": "http://www.soccermetrics.net"
  },
  "meta": {},
  "result": [
    {
      "desc": "western",
      "id": 10,
      "link": {},
      "uri": "/v1/name_order/10"
    },
    {
      "desc": "middle",
      "id": 11,
      "link": {},
      "uri": "/v1/name_order/11"
    },
    {
      "desc": "eastern",
      "id": 12,
      "link": {},
      "uri": "/v1/name_order/12"
    }
  ]
}

Players¶

GET /v1/players/(ID)¶

Returns primary and foreign key data on football players.

If ID is passed, returns data for the player the ID corresponds to.

If query parameters are passed, it returns the players who match the specified filters.

Note

In practice it shouldn’t be necessary to access this resource. The human-readable format is represented in the main Players resource.

Warning

GET requests to this resource without parameters are not recommended because of the large number of records that are retrieved.

Query and Response Parameters:

Field	Type	Description
person	uuid	The unique ID of person.
position	integer	The unique ID of the player’s default position.

Link Parameters:

Field	URL Description
person	Persons resource representation.

OPTIONS /v1/players¶

Returns documentation of the players resource.

Managers¶

GET /v1/managers/(ID)¶

Returns primary and foreign key data on football managers.

If ID is passed, returns data for the manager the ID corresponds to.

If query parameters are passed, it returns the managers who match the specified filters.

Note

In practice it shouldn’t be necessary to access this resource. The human-readable format is represented in the main Managers resource.

Warning

GET requests to this resource without parameters are not recommended because of the large number of records that are retrieved.

Query and Response Parameters:

Field	Type	Description
person	uuid	The unique ID of person.

Link Parameters:

Field	URL Description
person	Persons resource representation.

OPTIONS /v1/managers¶

Returns documentation of the managers resource.

Referees¶

GET /v1/referees/(ID)¶

Returns primary and foreign key data on football referees.

If ID is passed, returns data for the referee the ID corresponds to.

If query parameters are passed, it returns the referees who match the specified filters.

Note

In practice it shouldn’t be necessary to access this resource. The human-readable format is represented in the main Referees resource.

Warning

GET requests to this resource without parameters are not recommended because of the large number of records that are retrieved.

Query and Response Parameters:

Field	Type	Description
person	uuid	The unique ID of person.

Link Parameters:

Field	URL Description
person	Persons resource representation.

OPTIONS /v1/referee¶

Returns documentation of the referee resource.