The RTI (Remote Tracking Interface) allows you to use YellowFox functions and access its data via HTTP in third party software. You can find the technical documentation here.

Introduction

• the RTI function must be activated for your company by YellowFox indoor service. After a succesful activation you will find in the "Extras" menu the "RTI (interface)" option.
• For every car or group you want to use with the RTI must be get a authorization code. The combination of the object and the company key denied the unauthorized access of one of your vehicles.

Introduction YellowFox Remote Tracking Interface

With the YellowFox Remote Tracking Interface (RTI) has among others following portal functions:

• track a vehicle or group once
• set automatic trace every X KM
• set automatic trace every X Min
• activate the motion detector
• get the last poistion of a vehicle or a group
• Show the last position on map
• send orders to vehicles
• receive order states from vehicles
• send/ receive messages
• set up vehicles for Order Management/Message Management
• address import via YellowFox Geocoder

The description for available functions and their usage can be found via this link.

Generate the authorization keys

1. Go to the RTI (Extras --> RTI(interface))
2. Generate the key for the company. 
   1. Just select the "Create RTI key" action.
   2. The new 32 char key will be shown directly
3. Generate now the keys for you vehicles and groups you want to use for RTI. 
   1. For a single vehicle or group just use the action "Create RTI key" similar to get the company key.
   2. To generate the keys for multiple (or all) vehicles or groups first check the desired vehicles or groups and then use the upper left icon to "create RTI keys for selected elements"
   3. after a short waiting dialog the keys will be shown directly

4. To reject access to a vehicle or group either use the action "Delete RTI key" or again check the desired vehicles or groups and use the icon "delete RTI keys for selected elements" on top of the page

At every time you are able to generate new keys or to delete them. Please note, that if a new key was generated, the old one will be invalid.

The Remote Tracking Interface setup finished and you can use this function.

For each vehicle and group with a key there is an additional action "RTI links". Select this action will show a dialog with some example links to see how to use the rti functions with according return values.

Please note, if you want to use a group, all belonging vehicles must have a vehicle key. The allocation of a group key is not enough!

Settings

networkt access profiles

The RTI interface offers the possibility to access data from YellowFox and import it into another system. You might also import new data to Yellowfox. You might for example:

• access position data
• change vehicle settings
• get form or order data
• send new orders or messages
• upload files
• manage time bookings
• import addresses

The interface offers much more functions, which you can read about at the technical documentation. If you are interested to import Tours to YellowFox or to access tour data, you might take a look at the separate Tour Webservice. 

Requirements and Setup

The RTI interface must be activated by our in-house staff. Feel free to contact us. After the module has been unlocked, you can access its settings via the mainmenu → Administration → Administration → RTI Interface.

To use the interface you have to generate RTI keys first.

What is a RTI key?

The RTI interface uses a 2-step-authentification. This means you always have to pass 2 keys to avoid unauthorized access. These keys are generated at the portal. A key is a random hexadecimal code. RTI keys are sensitive information and should only be shared if needed. Only by using these keys you can get data via the interface. YellowFox distinguishes 4 types of keys:

• company key: This key identifies your company and is needed for any request.
• vehicle key: This key identifies a single vehicle. It is needed for accessing vehicle data, like e.g. position data.
• group key: This key identifies a vehicle group. By using a vehicle key you might e.g. get position data of all vehicles which are part of this group. Attention: Only data of vehicles which own a vehicle key will be returned!
• import key: This key is an universal key. It is used to access all cars or personnel data.

Create RTI keys

RTI keys are generated via the portal. Go to RTI Interface settings. At global keys you can generate the company and import key. If you already generated a key, you might also change or delete it. A change would lead to the key being generated again. This might be helpful if you unintentionally shared a key with someone who wasn't supposed to see it. If you remove a key, all functions which use it are not accessible anymore.

Via vehicle keys you can generate a key for each vehicle. Vehicles might be deactivated without having to remove the key. For example you could activate a key for a partner while the vehicle is working on a specific tour and after the tour is finished, you can lock the vehicle again. Vehicles can not only be identified by a key, but also by a so called RTI ident. While the key is generated automatically, you can set the ident by yourself. This might be helpful to manage keys easier in another program. Idents can only be used if you combine them with a valid group key. You can find the instructions to use RTI idents at the technical documentation. You can use the action menu to get some example calls via RTI Links.

Via vehicle group keys you can generate the keys for vehicle groups. Here you can also see the assignments of vehicles to each group and if the vehicles even have a key or are currently locked. Vehicles without vehicle keys are not considered in group requests even if they are assigned to the group.

Network assign profiles

If you created network assign profiles for your company, these do also influence RTI requests. You can assign them to your company at the settings. Request from an unknown network will be quit automatically.

Full documentation

These profiles can then be assigned to the company. When a request is made via the RTI, the first thing that is checked is whether the request comes from an IP address that is permitted via one of the assigned profiles.

Technical documentation