Skip to content

XXXCreate Teams

If there is any team aspect to the match (e.g. between countries or clubs), you can define the teams.

OpenTrack tries to "learn" the clubs in each country, identifying each with short mnemonic codes of up to 5 character - for example THH = Thames Hare & Hounds, or BEL = Belgrave Harriers. If we are working with you regularly, we suggest you get in touch to pre-load the clubs; then it is not necessary to create Team records. The record structure here is designed for "ad hoc teams" in one competition only. You can specify the URL to a flag - a 90x60 png file - which will appear in the results

JSON Structure

Below is the structure of the JSON for teams which can be added to the competition. These can then be linked to competitors by giving those competitors a team_id which is the equivalent of a team code.

"teams": [
    {
        "flag_url": "https://file.opentrack.run/live/clubflags/GBR/BEL.png", 
        "match_id": "match", 
        "team_id": "BEL", 
        "team_name": "Belgrave Harriers"
    }, 
    {
        "flag_url": "https://file.opentrack.run/live/clubflags/GBR/THH.png", 
        "match_id": "match", 
        "team_id": "THH", 
        "team_name": "Thames Hare & Hounds"
    }
],

Implemented Example

Below is an example with the different features added, in this case we can see this event also has competitors and events added alongside it. This is so we can see the athletes flag on the results page.

{
    "full_name": "api-test events teams",
    "short_name": "api-test",
    "slug": "api-test-slug-4",
    "name_local": "api-test",
    "country_id": "GBR",
    "address": "Kingsmeadow, Jack Goodchild Way, Kingston Road, Kingston upon Thames, UK",
    "date": "2020-08-10",
    "finish_date": "2020-08-15",
    "wa_rankings_category_id": "DF",
    "age_groups": ["ALL"],
    "basic_description": "This is an opentrack api test",
    "contact_details": "example@example.com",
    "organiser_id": "6b2af700-0481-4f73-b9ae-8221ae619b55",
    "website": "https://example.example",
    "entry_link": "https://example.example/entry",
    "results_link": "https://example.example/results",
    "competitors": [
        {
            "age_group": "NA", 
            "category": "NA",
            "competitor_id": "1", 
            "date_of_birth": "1966-03-21",
            "events_entered": [
                {
                    "event_code": "3k", 
                    "event_id": "1",
                }
            ], 
            "first_name": "Andrew",
            "gender": "M", 
            "last_name": "Robinson", 
            "nationality": "GBR",
            "ot_athlete_id": "44721dcd-3019-44f0-aab0-4b90eb98838d", 
            "team_id": "THH",
        },
        {
            "age_group": "NA", 
            "category": "NA",
            "competitor_id": "2", 
            "date_of_birth": "1967-08-22",
            "events_entered": [
                {
                    "event_code": "3k", 
                    "event_id": "1",
                }
            ], 
            "first_name": "Andy",
            "gender": "M", 
            "last_name": "Weir", 
            "nationality": "GBR",
            "ot_athlete_id": "332b0c3e-da43-4be6-af18-20a70fb23912", 
            "team_id": "THH",
        },
        {
            "age_group": "NA", 
            "category": "NA",
            "competitor_id": "3", 
            "date_of_birth": "1989-04-26",
            "events_entered": [
                {
                    "event_code": "3k", 
                    "event_id": "1",
                }
            ], 
            "first_name": "Gus",
            "gender": "M", 
            "last_name": "Upton", 
            "nationality": "GBR",
            "ot_athlete_id": "af0a1892-0c9d-4031-a4cf-690c3c37bc49", 
            "team_id": "BEL",
        }
    ], 
    "events": [
        {
            "age_groups": [
                "SEN"
            ],  
            "category": "3k_m",
            "day": 1, 
            "event_code": "3k", 
            "event_id": "1", 
            "genders": "M",
            "name": "3K run",
            "rounds": "1", 
            "status": "complete",
            "units": [
                {
                    "day": 1, 
                    "distance": 3000, 
                    "event_id": "1", 
                    "event_name": "3K run", 
                    "heat": 1, 
                    "heat_name": "1 3K run", 
                    "precision": 2, 
                    "results": [
                        {
                            "bib": "1", 
                            "catpos": 1,
                            "performance": "8:45.88", 
                            "place": 1
                        }, 
                        {
                            "bib": "3", 
                            "catpos": 2,
                            "performance": "9:32.07", 
                            "place": 2
                        }, 
                        {
                            "bib": "2", 
                            "catpos": 3,
                            "performance": "9:42.64", 
                            "place": 3
                        }
                    ], 
                    "results_status": "official", 
                    "round": 1, 
                    "scheduled_start_time": "13:45", 
                    "show_athlete_details": False,
                    "splits_lap": 200, 
                    "splits_start": 200, 
                    "status": "finished"
                }
            ]
        }
    ],
    "teams": [
        {
            "flag_url": "https://file.opentrack.run/live/clubflags/GBR/BEL.png", 
            "match_id": "match", 
            "team_id": "BEL", 
            "team_name": "Belgrave Harriers"
        }, 
        {
            "flag_url": "https://file.opentrack.run/live/clubflags/GBR/THH.png", 
            "match_id": "match", 
            "team_id": "THH", 
            "team_name": "Thames Hare & Hounds"
        }
    ]
}

and here is how the team looks loaded up alongside the competitor. As we can see the team code and flag appear on the competitor record.

Below you can also see how the teams now show up in the manage > teams section of the competition.

Method

A code example can be found at https://github.com/openath/opentrack-api-examples/blob/main/results_upload/api_create_teams.py.

The only change to be made to make this example runnable is to replace the EMAIL and PASSWORD string with your OpenTrack email and password that has authorisation to create competitions.