go to .NET-API documentation

The API supports entering data to the database by calling competition and discipline specific URLs with POST parameters containing the actual data.
The basic syntax for the URLs is: http://fs-live.org/[COMPETITION]/api/process-[DISCIPLINE].php

[COMPETITION] has to be replaced with the country or the name of your FS/FSAE competition. It is the same as used in the links on the home page. If your competition isn't linked yet, please write an email and you will get the exact wording.

[DISCIPLINE] has to be replaced by the following abbrevations for the individual disciplines:

Team Infos

The team's basic data must be administrated by hand in the admin area on the website.

POST parameters - general

You have to submit the data as POST parameters along the url call. Some parameters are the same for each discipline, some differ over the disciplines.
Make sure the car numbers are spelled in the same way as in the team infos section over all disciplines. Leading zeroes make a difference because the car numbers are handled as text. Car numbers with class prefixes are case insensitive.
Times may be entered with a comma or a point as decimal seperator.
For Skid Pad, Acceleration and Autocross use time value 888 for DNF and 999 for RERUN.
The mode parameter (Trackdrive/Endurance only) defines if a lap time gets added or the vehicle state gets changed. If the value is another than "save" the other parameters are not evaluated and don't have to be submitted.

POST parameters - Skid Pad

POST parameters - Acceleration

POST parameters - Autocross

POST parameters - Trackdrive

POST parameters - Endurance

possible return values

The return value is a string delivered from the webserver indicating if an error occured during script execution. Error detection and signaling isn't implemented completely yet. Possible values are:

The .NET-API is a wrapper for the web-API written in C#. It handles all the networking stuff and supplies easy-to-use functions to use in your timing software.

How to use the .NET-API

There are two ways how you can include the API into your project. (Description for C#-Project in Visual Studio 2015)

The first one is downloading the DLL file and add a reference to it in your project. To do this in Visual Studio right click on "References" in the Solution Explorer and choose "Add Reference...". In the opening window click on the "Browse..." button and select the dll file. Close the window with "OK".

The second one is downloading the source code file and add it to your project files. The advantage of this method is that you can customize the library to your individual needs. Keep in mind that future updates to the web-API will also result in changes in the .NET-API and you will have to merge the updated API with your customizations.

Please find a changelog and downloads of older versions here.

In both cases include "using FSlive" to your own code file. With this you can use the functions of the "PushToFSlive" and "FSliveConvert" classes.

Before you can use the other functions of PushToFSlive you have to call PushToFSlive.Init(...).

Team Infos

The team's basic data must be administrated by hand in the admin area on the website. See web-API

void PushToFSlive.Init(string key, string comp)

This function has to be called once before other functions of PushToFSlive can be used.
It initializes the API with competition dependend information.

string PushToFSlive.Skidpad(string carNr, float timeRight, float timeLeft)

Pushes Skidpad timings to the database.

string PushToFSlive.SkidpadState(string carNr, string state)

string PushToFSlive.SkidpadState(string carNr, string stateRight, string stateLeft)

Pushes Skidpad states (or timings) to the database.
Timing data has to be formatted as string with up to 3 decimals.
The 2-parameter version sets the same state/time to both laps and the overall state/average time.
The 3-parameter version sets the states/times of the laps independently. The overall state/average time is determined automatically.

string PushToFSlive.Acceleration(string carNr, float time)

Pushes Acceleration timings to the database.

string PushToFSlive.AccelerationState(string carNr, string state)

Pushes Acceleration state (or timing) to the database.
Timing data has to be formatted as string with up to 3 decimals.

string PushToFSlive.Autocross(string carNr, float time)

Pushes Autocross timings to the database.

string PushToFSlive.AutocrossState(string carNr, string state)

Pushes Autocross state (or timing) to the database.
Timing data has to be formatted as string with up to 3 decimals.

string PushToFSlive.Trackdrive(string carNr, int attempt, float time)

Pushes Trackdrive timings to the database. Sets the car state to "GO!" automatically.

string PushToFSlive.TrackdriveState(string carNr, int attempt, string state)

Sets the car state during Trackdrive.

string PushToFSlive.Endurance(string carNr, float time)

Pushes Endurance timings to the database. Sets the car state to "GO!" automatically.

string PushToFSlive.EnduranceState(string carNr, int attempt, string state)

Sets the car state during Endurance.

possible return values

see web-API