Getting Started

Vincent Trepanier -

Welcome to the Fleet Manager Mobile API docs. Our REST API allows programmatic access to Fleet Manager Mobile resources (e.g. vehicles, personnel, completed services and fuel entries) so developers can build integrations with 3rd-party and/or internal software systems. Each API resource has available actions that can be performed on it. Supported resources and their endpoints are listed at this page: 

https://api.fleetmanagermobile.com/v1/docs/index.html

The first thing you'll need to do is set up Authentication. This is handled using API keys. Each API key is associated with a Fleet Manager Mobile user. Results returned from various responses are based upon the role of the user to which the API key is tied.

1. Generating an API Key

Each Fleet Manager Mobile user can have multiple API keys. Here is how you can generate one from your Fleet Manager Mobile account. Navigate to "User Settings" menu: 
mceclip1.png

Click "Manage API Keys":
mceclip3.png
 
Next, click the "New API Key" button:
mceclip5.png
 
Then add a label for your API key. A label is simply a way of allowing you to organize your keys. 
 
The Account Token is a unique token provided with your business account. So all of your users will share the same account token. It's required to provide an Account Token for each request to our API. You can find yours in the Account Token column here: 
mceclip7.png

Important!
API keys are secret. Treat it as you would your password.


2. Set API Key and Account Token Headers

Each request to our API requires a valid API key AND Account Token to be passed as two HTTP headers: "api_key" and "account_token" OR as parameters in the query string. For example:
mceclip6.png

3. Try an API request using the API docs

You can test API calls in the online documentation. To do so, first enter your API Key and Account Token here : 
mceclip8.png

mceclip9.png

Click both "Authorize" buttons then click "Close"

You are now ready to test a call on the API. Just navigate to one of the endpoint and use the "Try it out" form. Here is an example with the "Fuel Entries" endpoint:
mceclip10.png

mceclip11.png

If you provided a valid API Key and Account Token, you should receive a list of fuel entries as a response as well as a response header with infos about the request:
mceclip12.png

4. Make an API request in the real world

Now you're ready to make requests to the Fleet Manager Mobile API using your programming tool of choice or a third party application.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.