API

Functional Racing exposes a small API for its apps.

Validity Checker

Graphical functionality is available in the web interface.

POST

Submit a data.acd file to validity check its content

This temporarily creates an entry accessible with the ID parameter in the GET operations below.

Syntax: curl -X POST <your parameters> https://functionalracing.com/api/validity/create

Parameters:

• name - Your car's title for this website (50 chars max; numbers, letters, blanks, underscores).
• path - The directory your data.acd file is inside (numbers, characters). Directory name only. No slashes.
• config_file - Your car's data.acd file.

Example: curl -X POST -d "name=RufTurbo_2001" -d "path=ruf_r_turbo_2001" -d "config_file=@/home/user/cars/ruf_r_turbo_2001/data.acd" https://functionalracing.com/api/validity/create

Return:

    {
      "name": "RufTurbo_2001",
      "id": "abcde01234ghijk56789"
      "errors": {"ini":{"digital_instruments.ini":["[ITEM_1] - PREFIX is blank, should be string", ...]}, "lut":{},"twodlut":{},"rto":{}}}
    }
    

GET

View all errors for a car's data.acd file

Existing cars are also viewable on the website at https://functionalracing.com/validity/<id>

Syntax: curl -X GET <your parameters> https://functionalracing.com/api/validity/show

Parameters:

• id - The ID of your car returned in the POST action above

Example: curl -X GET -d "id=abcde01234ghijk56789" https://functionalracing.com/api/validity/show

Return:

    {
      "name": "RufTurbo_2001",
      "errors": {"ini":{"digital_instruments.ini":["[ITEM_1] - PREFIX is blank, should be string", ...]}, "lut":{},"twodlut":{},"rto":{}}}
    }
    

Specify a subset of errors, per file type.

Syntax: curl -X GET <your parameters> https://functionalracing.com/api/validity/show

Parameters:

• id - The ID of your car returned in the POST action above
• section - The type of error file you want to view errors about (ini || lut || twodlut || rto)

Example: curl -X GET -d "id=abcde01234ghijk56789" -d "section=ini" https://functionalracing.com/api/validity/show

Return:

    {
      "name": "RufTurbo_2001",
      "errors":{"ini":{"digital_instruments.ini":["[ITEM_1] - PREFIX is blank, should be string", ...]}}
    }