sailing-analytics/tracking-app-api.md

Tracking App API

This document describes the API used by the tracking smartphone apps.

Device Mapping

Following POST call maps smartphones to competitors.

Verb

POST

Path

/sailingserver/rc/racelog
    ?leaderboard=Guy%27s+Regatta
    &raceColumn=M1
    &fleet=Default
    &clientuuid=92669a6c-72c9-46d2-a815-f51ff15a4369

Are query parameters really necessary?

Body

{
    "timestamp": 1413460233257,
    "id": "c72eabea-f456-4b29-9ba0-dadd06f5a179",
    "passId": 0, ***IS THIS NEEDED?***
    "fromMillis": 1413459900000,
    "@class": "DeviceCompetitorMappingEvent",
    "createdAt": 1413460233258,
    "item": {
        "id": "da815c7f-c935-44f5-b01d-20b750ce75ab",
        "nationality": "", ***IS THIS NEEDED?***
        "displayColor": null, ***IS THIS NEEDED?***
        "idtype": "java.util.UUID",
        "name": null, ***IS THIS NEEDED?***
        "nationalityISO3": "", ***IS THIS NEEDED?***
        "sailID": "", ***IS THIS NEEDED?***
        "nationalityISO2": "" ***IS THIS NEEDED?***
    },
    "authorName": "Tracking App",
    "competitors": [ ], ***IS THIS NEEDED?***
    "device": {
        "stringRepresentation": "147d8230-4db0-11e4-916c-0800200c9a66",
        "id": "147d8230-4db0-11e4-916c-0800200c9a66",
        "type": "smartphoneUUID"
    },
    "authorPriority": 0, ***IS THIS NEEDED?***
    "toMillis": 1413460500000
}

Response

Currently 404

GPSFix

Verb

POST

Path

???

Body

???

Response

???